medusa-mcp

概述

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

---

🧩 什么是 MCP 服务器？

MCP 服务器是一个模块化、可扩展的后端，它：

• 启用实时服务编排
• 支持标准化、高吞吐量通信
• 充当 AI/自动化工具与现实世界系统之间的桥梁

这些服务器用于 AI、物联网和企业软件等领域，以连接各种服务并使用 JSON-RPC 等标准化协议自动执行任务。

🔑 主要特性

• 模块化架构 – 用于灵活性的可组合服务
• 高效率 – 针对速度和规模进行了优化
• 可扩展设计 – 轻松添加新功能
• 跨环境部署 – 云、本地或混合
• AI 就绪接口 – 无缝集成 LLM 和工具

🧠 在 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 助手 /      |
       |     LLM / 自动化    |
       +-----------+-------------+
                   |
                   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 重新生成这些文件。

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

---

🤝 贡献

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

---

📄 许可证

本项目根据 MIT 许可证获得许可。 有关详细信息，请参阅 LICENSE 文件。