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、本番環境
コマンドライン引数	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（任意）	既存の GraphQL クエリ、REST 呼び出し、または統合スニペットを、設定された Adobe Commerce バージョンに対して検証します。各型、フィールド、引数、エンドポイントを ✅ 有効、⚠️ 非推奨、❌ 無効として報告し、必要に応じて修正版のコードを提供します。

ローカルストアの GraphQL スキーマを取得する

ローカルストアに対してイントロスペクションクエリを実行し、結果を gzip 圧縮ファイルとして data/ フォルダに保存します。

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