Adobe Commerce Dev MCP

Name: Adobe Commerce Dev MCP
Author: rafaelstz

@rafaelstz

代码仓库主页

关于 Adobe Commerce Dev MCP

Adobe Commerce Dev MCP Server

#magento #adobe-commerce

基本信息

分类

其他

许可证

ISC

运行时

node

传输方式

stdio

发布者

rafaelstz

提交者

Rafael Corrêa Gomes

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

This tool introspects and returns the portion of the Adobe Commerce GraphQL schema relevant to the user prompt. Only use this for the Adobe Commerce API. It takes two arguments: query and filter. The query argument is the string search term to filter schema elements by name. The filter argument is an array of strings to filter results to show specific sections.

概览

What is Adobe Commerce Dev MCP?

Adobe Commerce Dev MCP is a Model Context Protocol server that interacts with Adobe Commerce. It provides tools to search the GraphQL and REST API schemas, and prompts to help write and validate API integrations.

How to use Adobe Commerce Dev MCP?

Use it by configuring an MCP client (e.g., Cursor, Claude Desktop) to run the NPM package @rafaelcg/adobe-commerce-dev-mcp@latest via npx. Set the environment variable ADOBE_COMMERCE_VERSION to your store version (2.4.7 or 2.4.8). No local installation is needed.

Key features of Adobe Commerce Dev MCP

Search Adobe Commerce GraphQL schema for types, queries, and mutations.
Search Adobe Commerce REST API (OpenAPI 2.0) schema for endpoints and definitions.
Helps write GraphQL operations or REST requests with automatic API type selection.
Validates existing GraphQL queries, REST calls, or integration snippets.
Reports valid, deprecated, or invalid fields with corrected code suggestions.
Supports Adobe Commerce versions 2.4.7 and 2.4.8.

Use cases of Adobe Commerce Dev MCP

Quickly look up GraphQL types and REST endpoints during development.
Generate properly formatted API requests for custom integrations.
Validate third-party code against a specific Adobe Commerce version.
Automate API schema exploration without switching context.

FAQ from Adobe Commerce Dev MCP

How do I configure the Adobe Commerce version?

Set the ADOBE_COMMERCE_VERSION environment variable in your MCP client config. Supported versions are 2.4.7 and 2.4.8 (default).

Can I use my own store’s schema?

Yes. Run an introspection query against your local store and save the gzipped JSON file into the data/ folder. The server will load your custom schema for the configured version.

What happens if the REST schema file for my version is missing?

The server falls back to version 2.4.8 and includes a note in the tool response.

How do I run the server locally for development?

Clone the repo, run npm install, modify source files, then npm run build. Use an MCP config pointing to dist/index.js or run npm run inspector for testing.