AI导哈

Magento 2 MCP服务器

Magento 2的模型上下文协议（MCP）服务器实现，通过标准化接口使AI助手能够与Magento商店交互。

  • by dzmitry-vasileuski
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dzmitry-vasileuski/magento2-mcp-server

使用说明

Magento 2 MCP服务器

Magento 2的模型上下文协议（MCP）服务器实现，使AI助手能够通过标准化的界面与您的Magento商店进行交互。

特性

  • REST API与Magento 2的集成
  • 安全身份验证处理
  • 用于常见Magento操作的资源和工具处理程序
  • 用于类型安全的TypeScript实现
  • 基于官方MCP SDK构建

先决条件

  • Node.js（v18或更高版本）
  • npm（v8或更高版本）
  • 具有REST API访问权限的Magento 2实例
  • 管理来自Magento的API访问令牌

安装

npm install vasileuski/magento2-mcp-server

用法

启动服务器

magento <magento_url> <admin_api_token>

例子：

magento https://your-magento-store.com eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

与MCP客户端集成

要将此服务器与MCP客户端（如Cursor）一起使用，请将以下配置添加到客户端设置中：

{
  "tools": [
    {
      "name": "mcp_magento_magento_rest_api",
      "command": "magento https://your-magento-store.com your-admin-api-token"
    }
  ]
}

这将实现以下功能：

  • REST API访问您的Magento实例
  • 模式自省
  • 资源列表和阅读
  • 用于常见Magento操作的工具执行

可用工具

magento_rest_api

对Magento实例进行REST API调用。

参数：

  • path：API终结点路径
  • method：HTTP方法（GET、POST、PUT、DELETE）
  • body：请求正文（JSON字符串）
  • query：查询参数

MCP客户端中的示例用法：

const response = await mcp.magento_rest_api({
  path: "rest/V1/orders",
  method: "GET",
  body: "",
  query: "searchCriteria[pageSize]=3&searchCriteria[currentPage]=1"
});

发展

  1. 克隆存储库
  2. 安装依赖项： npm install
  3. 启动开发服务器： npm run dev
  4. 进行更改
  5. 运行测试： npm test
  6. 生产建设： npm run build

安全

  • 永远不要提交你的Magento管理员令牌
  • 对敏感信息使用环境变量
  • 让你的Node.js和npm版本保持最新
  • 定期更新依赖关系

许可证

麻省理工学院

相关 MCP