Medusa MCP Server

](https://mseep.ai/app/sgfgov-medusa-mcp)

medusa-mcp

概述

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

______________________________________________________________________

🧩 什么是MCP服务器？

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

• 启用 实时服务编排
• 支持 标准化、高通量通信
• 作为一个 AI/自动化工具和现实系统之间的桥梁

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

🔑 主要特点

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

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

MCP服务器允许AI代理：

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

______________________________________________________________________

______________________________________________________________________

🚀 美杜莎JS+MCP

使用 medusa-mcp，美杜莎JS可以：

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

______________________________________________________________________

✨ 特性

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

______________________________________________________________________

🛠️ 安装

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

npm install

构建项目：

npm run build

______________________________________________________________________

▶️ 用法

启动服务器：

npm start

使用MCP检查器进行测试：

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

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

______________________________________________________________________

🛠️ 从该MCP服务器生成Claude技能

您可以使用以下工具将此MCP服务器转换为Claude Skill mcp-to-skill.py 脚本来自 mcp-to-skill-converter 项目，该内容包含在此回购中 mcp-to-skill.py.

1. 构建MCP服务器 （因此配置中的命令有效）：

   npm run build

1. 确保Python和 mcp 套餐可用:

   pip install mcp

1. 为此服务器生成技能 使用提供的 mcp-to-skill.json 配置：

   python mcp-to-skill.py --mcp-config mcp-to-skill.json --output-dir ./skills/medusa-mcp

这将创建：

- SKILL.md –给克劳德的说明 - executor.py –MCP通信处理程序 - mcp-config.json –MCP服务器配置 - package.json –对技能的依赖性最小

1. 为克劳德安装技能:

   cd skills/medusa-mcp
   pip install mcp
   cp -r . ~/.claude/skills/medusa-mcp

克劳德将在下次启动时自动发现新技能。

______________________________________________________________________

🌍 环境变量

服务器运行时间： 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) |
      +-------------------------+

🧪 定制

要根据您的美杜莎设置定制服务器：

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

• 替换中的OpenAPI模式 oas/ 文件夹：

- admin.json –管理端点 - store.json –店面端点

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

你也可以 fork这个项目 构建您自己的定制MCP驱动的Medusa集成。

______________________________________________________________________

🤝 贡献

我们欢迎捐款！请查看我们的 贡献.md 导游。

______________________________________________________________________

📄 许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。