适合谁
- 使用 Medusa JS 构建电商平台并希望以 AI 代理自动化运营的开发者
- 需要将 Medusa 后端接入 LLM 工具链的团队
- 愿意自行定制 OpenAPI 定义以细粒度控制工具的工程师
M
43FMRS · D
一个面向 Medusa JS SDK 的社区 MCP 服务器，主打可扩展架构和 AI 自动化集成，支持通过 OpenAPI 定义自定义工具并转换为 Claude Skill。适合具备 Medusa 和 Node.js 经验的开发者，但缺少官方背书和详细的工具文档，使用前需自行评估安全性和功能完整性。
medusa-mcp 是一个模型上下文协议（MCP）服务器，用于与 Medusa JavaScript SDK 集成。它为管理和操作 Medusa 的数据模型提供可扩展的后端层，支持自动化、编排和智能化服务扩展，可用于库存或价格调整等工作流自动化、连接外部工具（如邮件、分析），以及让 AI 代理分析趋势并触发操作。该项目为 MIT 许可的开源社区项目，并非 Medusa 官方维护。
安装接入
- 克隆仓库 https://github.com/SGFGOV/medusa-mcp 并运行 npm install；2. 运行 npm run build 构建；3. 配置环境变量：MEDUSA_BACKEND_URL（Medusa 后端地址）、PUBLISHABLE_KEY（可发布 API 密钥）、MEDUSA_USERNAME 与 MEDUSA_PASSWORD（管理员凭据）；4. 通过 npm start 启动服务器；5. 可用 npx @modelcontextprotocol/inspector ./dist/index.js 进行测试（每次重新构建后需重启 Inspector 和浏览器）。
选型与风险
不适合谁
- 不使用 Medusa 的电商或应用项目
- 寻求 Medusa 官方支持或托管解决方案的用户
- 无法自行部署 Node.js 服务或管理环境变量凭据的非技术用户
所需权限
- 需要访问 Medusa 后端 URL 的网络权限
- 需要 Medusa 可发布 API 密钥（PUBLISHABLE_KEY）
- 执行管理操作时需要 Medusa 管理员用户名和密码
风险与副作用
- 管理员账号密码需以环境变量形式存储，存在凭据泄露风险
- AI 代理可触发真实商务操作（如订单履行、价格更新），误操作可能影响生产数据
- 服务器默认运行在 localhost:3000，若暴露到网络需自行确保安全
- 该项目未声明服务器工具清单，实际能力需自行审查源码确认
常见排障
- 每次重新构建后需重启 MCP Inspector 和浏览器
- 检查 MEDUSA_BACKEND_URL 与 PUBLISHABLE_KEY 是否正确配置
- 若管理端工具不可用，确认 MEDUSA_USERNAME 和 MEDUSA_PASSWORD 是否提供
- 构建失败时先运行 npm install 确认依赖完整
- 如需自定义工具，确认 oas/ 目录下的 admin. 与 store. 是否为最新的 OAS 定义
使用场景
自动化库存或价格调整等商务工作流
让 AI 代理访问 Medusa 后端的产品与订单数据
通过 OpenAPI 定义（oas/admin.、oas/store.）自定义管理端与商店端工具
使用 mcp-to-skill.py 将该服务器转换为 Claude Skill