`medusa-mcp`

概述

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

🧩 什么是 MCP 服务器？

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

支持实时服务编排
支持标准化、高吞吐量通信
充当人工智能/自动化工具和现实世界系统之间的桥梁

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

🔑 主要特点

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

🧠 在人工智能系统中的作用

MCP 服务器允许 AI 代理：

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

🚀 美杜莎 JS + MCP

使用medusa-mcp ，Medusa JS 可以：

自动化工作流程（例如库存或价格调整）
连接外部工具（电子邮件、分析等）
使用人工智能代理分析趋势并触发行动
为商业平台提供可扩展的模块化架构

✨ 特点

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

🛠️ 安装

克隆存储库并安装依赖项：

npm install

构建项目：

npm run build

▶️ 使用方法

启动服务器：

npm start

使用 MCP 检查器进行测试：

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

**注意：**每次重建后重新启动检查器和浏览器。

🌍 环境变量

多变的	描述
`MEDUSA_BACKEND_URL`	您的 Medusa 后端 URL
`PUBLISHABLE_KEY`	您的 Medusa 可发布 API 密钥
`MEDUSA_USERNAME`	Medusa 管理员用户名（用于管理员）
`MEDUSA_PASSWORD`	Medusa 管理员密码（用于管理员）

服务器运行于： http://localhost:3000

🧠 架构图

以下是medusa-mcp服务器如何与 Medusa JS 和外部系统一起适应典型设置：

       +-------------------------+
       |     AI Assistant /      |
       |     LLM / Automation    |
       +-----------+-------------+
                   |
                   v
    +--------------+--------------+
    |     MCP Server (medusa-mcp) |
    |-----------------------------|
    | - JSON-RPC Communication    |
    | - AI-Ready Interface        |
    | - Plugin Support            |
    +------+----------------------+
                   |                             
                   +
                   |                                                         
                   v                                                         
         +-------------------+
         | Medusa Backend    |
         | (Products, Orders)|
         +-------------------+
                   |
                   |
                   v
           +--------------+
           | Medusa Store |
           | Frontend     |
           +--------------+
                   |
                   |
                   v
      +-------------------------+
      | External Services / API |
      | (e.g., Payments, Email) |
      +-------------------------+

🧪 定制

要根据您的 Medusa 设置定制服务器：

将admin.json和store.json替换为您自己的 OAS 定义，以实现细粒度控制。

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

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

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

🤝 贡献

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

📄 许可证

本项目遵循 MIT 许可证。详情请参阅LICENSE文件。

Medusa MCP Server

Integrations