【技术文档摘要】

medusa-mcp

概述

medusa-mcp 是一个专为与 Medusa JavaScript SDK 集成而设计的 模型上下文协议（MCP）服务器。它提供了一个可扩展的后端层，用于管理和交互 Medusa 的数据模型，从而实现自动化、编排和智能服务扩展。

---

🧩 什么是 MCP 服务器？

MCP 服务器 是一种模块化且可扩展的后端，具有以下功能：

• 实现 实时服务编排
• 支持 标准化、高吞吐量通信
• 作为 AI/自动化工具与实际系统之间的桥梁

这些服务器在人工智能、物联网和企业软件等领域中使用，通过像 JSON-RPC 这样的标准化协议连接各种服务并实现任务自动化。

🔑 主要特点

• 模块化架构 —— 可组合的服务以提高灵活性
• 高效性 —— 优化速度和规模
• 可扩展设计 —— 容易添加新功能
• 跨环境部署 —— 支持云、本地或混合环境
• AI 就绪接口 —— 无缝集成大语言模型和工具

🧠 在 AI 系统中的角色

MCP 服务器允许 AI 代理：

• 访问来自 API、文件或数据库的实时数据
• 自动化业务流程（例如订单履行、价格更新）
• 安全可控地与外部服务交互

---

🚀 Medusa JS + MCP

使用 medusa-mcp，Medusa JS 可以：

• 自动化工作流（例如库存或定价调整）
• 连接外部工具（电子邮件、分析等）
• 使用 AI 代理分析趋势并触发操作
• 为电子商务平台启用可扩展、模块化的架构

---

✨ 特点

• ✅ 模型上下文协议（MCP） 支持
• 📈 可扩展 基础设施
• 🧱 可扩展 插件架构
• 🔗 集成 Medusa JS SDK

---

🛠️ 安装

克隆仓库并安装依赖项：

npm install

构建项目：

npm run build

---

▶️ 使用

启动服务器：

npm start

使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector ./dist/index.js

注意： 每次重新构建后，请重启 Inspector 和浏览器。

---

🌍 环境变量

变量名称	描述
MEDUSA_BACKEND_URL	您的 Medusa 后端 URL
PUBLISHABLE_KEY	您的 Medusa 发布 API 密钥
MEDUSA_USERNAME	Medusa 管理员用户名（仅限管理员）
MEDUSA_PASSWORD	Medusa 管理员密码（仅限管理员）

服务器运行地址：http://localhost:3000

---

🧠 架构图

这是 medusa-mcp 服务器如何融入典型的 Medusa JS 和外部系统设置：

       +-------------------------+
       |     AI 助手 /          |
       |     大语言模型 / 自动化 |
       +-----------+-------------+
                   |
                   v
    +--------------+--------------+
    |     MCP 服务器 (medusa-mcp) |
    |-----------------------------|
    | - JSON-RPC 通信             |
    | - AI 就绪接口               |
    | - 插件支持                 |
    +------+----------------------+
                   |                             
                   +
                   |                                                         
                   v                                                         
         +-------------------+
         | Medusa 后端       |
         | (产品、订单)      |
         +-------------------+
                   |
                   |
                   v
           +--------------+
           | Medusa 商店   |
           | 前端          |
           +--------------+
                   |
                   |
                   v
      +-------------------------+
      | 外部服务 / API          |
      | (例如，支付、电子邮件)  |
      +-------------------------+

🧪 定制

为了使服务器适应您的 Medusa 设置：

替换 admin.json 和 store.json 文件，使用您自己的 OAS 定义进行细粒度控制。

• 替换 oas/ 文件夹中的 OpenAPI 模式：
  • admin.json – 管理端点
  • store.json – 商店前端端点

使用 @medusajs/medusa-oas-cli 重新生成这些文件。

您也可以 分叉此项目 来构建您自己的自定义 MCP 驱动的 Medusa 集成。

---

🤝 贡献

我们欢迎贡献！请参阅我们的 CONTRIBUTING.md 指南。

---

📄 许可证

本项目采用 MIT 许可证。详情请参见 LICENSE 文件。