Medusa MCP Server

社区

连接 Medusa JS SDK 的 MCP 服务器

分类: 开发工具第 327 / 438
Stars: ★ 71 热门
传输方式: stdio（本地进程）
运行环境: Node.js · Python
凭据: 可选 API Key
许可证: MIT
最近提交: 6 个月前 ⚠

43FMRS · D

一个面向 Medusa JS SDK 的社区 MCP 服务器，主打可扩展架构和 AI 自动化集成，支持通过 OpenAPI 定义自定义工具并转换为 Claude Skill。适合具备 Medusa 和 Node.js 经验的开发者，但缺少官方背书和详细的工具文档，使用前需自行评估安全性和功能完整性。

最强项 · 安装易用性 10/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

7/20

维护活跃度

10/20

文档质量

10/20

安装易用性

10/20

查看各项评分依据

可靠性 6/20: README 仅给出 npm install / npm run build / npm start 及使用 MCP Inspector 手动测试的步骤，没有提供任何自动化测试、CI 工作流或错误处理说明的证据；由于服务器清单未缓存，无法核实声明的工具列表与实际行为是否一致。按静态评审规则，没有可验证的执行证据（CI + 测试）时可靠性上限为12分，故给予中低分。
安全与权限 7/20: 凭证（MEDUSA_USERNAME/MEDUSA_PASSWORD、PUBLISHABLE_KEY）通过环境变量传入，属于常见做法，未发现明文硬编码密钥或明显的凭证窃取行为。但 README 未说明最小权限范围、未提及对危险操作（如订单、退款、删除产品等 Medusa 管理端点）的确认机制，也未披露数据流向或外部网络访问的边界，因此风险可见但缓解措施不完整，不构成红线但也不能给高分。
维护活跃度 10/20: 项目使用 MIT 许可证，未被归档，仓库有68星、仅1个未解决issue，且存在 CONTRIBUTING.md 表明有一定治理规范。但 README 未提供发布历史、版本号策略、安全响应渠道或依赖更新流程的信息，无法判断维护活跃度的持续性，故评为中等。
文档质量 10/20: 文档涵盖了安装、构建、启动、环境变量表格、架构图以及通过 OAS 文件自定义端点的说明，具有一定层次性。但缺少具体工具参数说明、调用限制、成本说明以及故障排查章节（仅提及“重建后需重启 Inspector”），存在隐藏假设，故评为中等。
安装易用性 10/20: 安装步骤简单明了（clone、npm install、npm run build、npm start），并给出了环境变量表。但未提供在主流客户端（如 Claude Desktop）中配置该 MCP 服务器的具体配置示例，也未说明跨平台兼容性，安装流程仍偏手动，按静态评审规则在缺乏可验证执行证据时上限为15分，故评为中等。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Medusa JS 构建电商平台并希望以 AI 代理自动化运营的开发者
需要将 Medusa 后端接入 LLM 工具链的团队
愿意自行定制 OpenAPI 定义以细粒度控制工具的工程师

不适合谁

不使用 Medusa 的电商或应用项目
寻求 Medusa 官方支持或托管解决方案的用户
无法自行部署 Node.js 服务或管理环境变量凭据的非技术用户

所需权限

需要访问 Medusa 后端 URL 的网络权限
需要 Medusa 可发布 API 密钥（PUBLISHABLE_KEY）
执行管理操作时需要 Medusa 管理员用户名和密码

风险与副作用

管理员账号密码需以环境变量形式存储，存在凭据泄露风险
AI 代理可触发真实商务操作（如订单履行、价格更新），误操作可能影响生产数据
服务器默认运行在 localhost:3000，若暴露到网络需自行确保安全
该项目未声明服务器工具清单，实际能力需自行审查源码确认

安装接入

准备工作

运行环境：Node.js · Python

MEDUSA_BACKEND_URL 必填你的 Medusa 后端地址，由你自己的 Medusa 部署提供。

PUBLISHABLE_KEY 可选密钥 Medusa 后台的 publishable API key，在 Medusa 管理后台生成。

MEDUSA_PASSWORD 可选密钥 Medusa 管理员密码，用于 admin 操作。

其他可选配置项（1 个）

MEDUSA_USERNAME 可选 Medusa 管理员用户名，用于 admin 操作。

克隆仓库 https://github.com/SGFGOV/medusa-mcp 并运行 npm install
运行 npm run build 构建
配置环境变量：MEDUSA_BACKEND_URL（Medusa 后端地址）、PUBLISHABLE_KEY（可发布 API 密钥）、MEDUSA_USERNAME 与 MEDUSA_PASSWORD（管理员凭据）
通过 npm start 启动服务器
可用 npx @modelcontextprotocol/inspector ./dist/index.js 进行测试（每次重新构建后需重启 Inspector 和浏览器）。

验证是否装好

运行 npx @modelcontextprotocol/inspector ./dist/index.js，在 Inspector 中确认服务器启动并暴露 Medusa 相关工具；服务器默认运行在 http://localhost:3000。

常见排障

每次重新构建后需重启 MCP Inspector 和浏览器
检查 MEDUSA_BACKEND_URL 与 PUBLISHABLE_KEY 是否正确配置
若管理端工具不可用，确认 MEDUSA_USERNAME 和 MEDUSA_PASSWORD 是否提供
构建失败时先运行 npm install 确认依赖完整
如需自定义工具，确认 oas/ 目录下的 admin. 与 store. 是否为最新的 OAS 定义

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 Medusa 后台的商品数据
帮我把某个商品的价格调低 10%
查询最近的订单状态

使用场景

自动化库存或价格调整等商务工作流

让 AI 代理访问 Medusa 后端的产品与订单数据

通过 OpenAPI 定义（oas/admin.、oas/store.）自定义管理端与商店端工具

使用 mcp-to-skill.py 将该服务器转换为 Claude Skill

详细介绍

medusa-mcp 是一个模型上下文协议（MCP）服务器，用于与 Medusa JavaScript SDK 集成。它为管理和操作 Medusa 的数据模型提供可扩展的后端层，支持自动化、编排和智能化服务扩展，可用于库存或价格调整等工作流自动化、连接外部工具（如邮件、分析），以及让 AI 代理分析趋势并触发操作。该项目为 MIT 许可的开源社区项目，并非 Medusa 官方维护。

Medusa MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

使用场景

详细介绍

同类可选方案