Adobe Commerce Dev MCP

通过 NPM 包使用 MCP 服务

无需自行下载或托管任何内容，即可直接使用此 MCP 服务。只需配置 MCP 客户端（例如 Cursor 或 Claude Desktop）以使用 NPM 包：

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@rafaelcg/adobe-commerce-dev-mcp@latest"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

• 可根据需要替换服务名称（adobe-commerce-dev-mcp）。
• npx 命令始终会从 NPM 使用最新版本的 MCP 服务。
• 将 ADOBE_COMMERCE_VERSION 设置为与你的商店匹配的版本（2.4.7 或 2.4.8）。默认值为 2.4.8。
• 无需在本地或远程安装或托管任何内容。

在 Windows 上，你可能需要使用以下替代配置：

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@rafaelcg/adobe-commerce-dev-mcp@latest"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

版本配置

ADOBE_COMMERCE_VERSION 设置决定工具加载哪些架构文件，以及提示词中引用的版本。

方法	示例	适用场景
MCP 配置中的 env	"ADOBE_COMMERCE_VERSION": "2.4.7"	Claude Desktop、Cursor、生产环境
CLI 参数	Arguments 字段中的 ADOBE_COMMERCE_VERSION=2.4.7	MCP Inspector

支持的版本：2.4.7、2.4.8（默认值）。

REST 架构回退： 如果找不到所配置版本的 REST 架构文件，服务会回退到 2.4.8，并在工具响应中附带说明。

可用工具

工具	描述
introspect_admin_graphql_schema	在 Adobe Commerce GraphQL 架构中搜索与关键词匹配的类型、查询和变更
introspect_admin_rest_schema	在 Adobe Commerce REST API（OpenAPI 2.0）架构中搜索与关键词匹配的端点和定义

两个工具都会使用为 ADOBE_COMMERCE_VERSION 配置的架构。

可用提示词

提示词	参数	描述
adobe_commerce_api	query（必需）、api_type: graphql | rest | auto（可选，默认值为 auto）	帮助你编写 GraphQL 操作或 REST 请求。当 api_type 为 auto 时，AI 会针对使用场景选择最合适的 API 并说明原因。
validate_adobe_commerce_implementation	code（必需）、context（可选）	根据配置的 Adobe Commerce 版本验证现有 GraphQL 查询、REST 调用或集成代码片段。会将每种类型、字段、参数和端点标记为 ✅ 有效、⚠️ 已弃用或 ❌ 无效，并在需要时提供修正后的代码。

获取本地商店的 GraphQL 架构

针对本地商店运行内省查询，并将结果保存为 data/ 文件夹中的 gzip 压缩文件：

curl -s https://magento.test/graphql \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  --insecure \
  -d '{"query":"fragment FullType on __Type { kind name description fields(includeDeprecated: true) { name description args { ...InputValue } type { ...TypeRef } isDeprecated deprecationReason } inputFields { ...InputValue } interfaces { ...TypeRef } enumValues(includeDeprecated: true) { name description isDeprecated deprecationReason } possibleTypes { ...TypeRef } } fragment InputValue on __InputValue { name description type { ...TypeRef } defaultValue } fragment TypeRef on __Type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } query IntrospectionQuery { __schema { queryType { name } mutationType { name } subscriptionType { name } types { ...FullType } directives { name description locations args { ...InputValue } } } }"}' \
  | gzip > data/schema_2-4-8.json.gz

如有需要，请先获取管理员令牌：

curl -s -X POST https://magento.test/rest/V1/integration/admin/token \
  --insecure \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"YOUR_PASSWORD"}'

获取本地商店的 REST API 架构

curl -s "https://magento.test/rest/all/schema?services=all" \
  --insecure \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  | gzip > data/rest_schema_2-4-8_admin.json.gz

开发

该服务使用 MCP SDK 构建，并与 Adobe Commerce 通信。

1. npm install
2. 修改源文件
3. 运行 npm run build 进行编译
4. 运行 npm test 运行测试
5. 添加一个指向构建文件的 MCP 服务（见下文）

本地 MCP 配置：

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/adobe-commerce-dev-mcp/dist/index.js"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

MCP Inspector：

npm run inspector

然后在 Arguments 字段中设置 ADOBE_COMMERCE_VERSION=2.4.7（或任何受支持的版本），即可切换架构，无需重启。

许可证

ISC