Adobe Commerce MCP

adobe-commerce-mcp

PHP 製 Adobe Commerce モジュール用 MCP サーバー。ネットワーク接続も認証情報も不要です。

インストール

claude mcp add adobe-commerce -- npx -y adobe-commerce-mcp

Node >= 18 が必要です。クライアントは npx でサーバーを実行するため、インストールは不要です。Claude Desktop、Cursor、Windsurf、VS Code などのクライアントについては、その他のクライアントをご覧ください。

クイックスタート

クライアントを再起動し、必要なことを自然言語で伝えてください。アシスタントがツールを選択します。

• 「Magento_Catalog に依存する Acme_Reviews モジュールを作成して」
• 「Magento\Catalog\Model\Product::getName に after プラグインを追加して」
• 「system.xml はどこに置くの？ XSD はどれ？」
• 「catalog_product_entity への外部キーを持つ acme_review テーブルを作成して」
• 「bin/magento setup:static-content:deploy にはどんなオプションがあるの？」
• 「addProductsToCart mutation はどんな引数を受け取るの？」

含まれるもの

PaaS または自社サーバー上で Adobe Commerce（Magento Open Source）モジュールを開発する方向けです。di.xml、プラグイン、オブザーバー、レイアウト、db_schema.xml、webapi.xml など、PHP 開発で日常的に使うものを扱います。

• オフラインの公式ドキュメント：AdobeDocs の 4 つのリポジトリから集めた 1,896 ページを、セクション単位で BM25 検索できます。各検索結果には、タイトル、公開 URL、元のリポジトリ内のパスが含まれます。
• 設定ファイル：それぞれの役割、配置場所（フォルダーとエリア）、ドキュメントに記載されている場合は XSD の URN、および説明しているページがわかります。
• CLI と Web API：bin/magento の 147 個のコマンド（2.4.9）とそのオプション、OpenAPI スキーマの 614 個の REST エンドポイント、GraphQL の 225 個のクエリと mutation を収録しています。
• スキャフォールディング：モジュール、プラグイン、オブザーバー、コントローラー、db_schema.xml のテーブルを作成できます。ツールはクライアントが書き込めるように、ファイル（パスと内容）を返します。各ファイルには、参照元となったドキュメントページが記載されています。
• ローカルで動作し、認証情報は不要：接続を開かず、ログインも求めず、ディスクへの書き込みも行いません。ナレッジはすべて data/ にあります。

Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、および stdio トランスポートを使うすべての MCP クライアントで動作します。

開発の背景

Adobe 公式 MCP の @adobe-commerce/commerce-extensibility-tools は、App Builder を使った開発（aio コマンド）を対象としています。ドキュメントを検索するだけでも Adobe IMS へのログイン（aio auth login）が必要です。ライセンスは独自の EULA であり、ツールの 1 つは会話履歴を Adobe に送信します。App Builder で開発する場合は、そちらをご利用ください。PHP 開発向けの公式サーバーはありません。このサーバーは、Adobe Commerce の公開ドキュメントを使い、アカウントもネットワーク接続も不要で、MIT ライセンスのもと、その用途に対応します。

ドキュメント

その他のクライアント

claude_desktop_config.json（Claude Desktop）、~/.cursor/mcp.json または .cursor/mcp.json（Cursor）、~/.codeium/windsurf/mcp_config.json（Windsurf）に設定します。

{
  "mcpServers": {
    "adobe-commerce": {
      "command": "npx",
      "args": ["-y", "adobe-commerce-mcp"]
    }
  }
}

VS Code では、.vscode/mcp.json に設定します。

{
  "servers": {
    "adobe-commerce": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "adobe-commerce-mcp"]
    }
  }
}

stdio トランスポートを使うクライアントであれば、どれでも使用できます。コマンドは npx、引数は -y adobe-commerce-mcp です。グローバルにインストールした場合（npm install -g adobe-commerce-mcp）、コマンドは adobe-commerce-mcp です。Claude Code では、--scope project を指定すると設定が .mcp.json に保存され、チームで共有できます。

ツール

エントリーポイントの src/index.ts が stdio 経由でサーバーに接続し、10 個のツールを src/tools/index.ts に登録します。

ドキュメントとリファレンス

ツール	パラメーター	内容
search-docs	query, area?, limit?	ドキュメントを検索します。area は php、frontend、webapi、operations のいずれかです。タイトル、URL、ソースパスを含む抜粋を返します。
read-doc	ref, section?	ID、ソースパス、または公開 URL で指定したページ全体またはセクションを返します。
explain-config-file	file	設定ファイルを説明します。対象は di.xml、events.xml、webapi.xml、db_schema.xml、crontab.xml、routes.xml、system.xml、acl.xml、layout、およびその他 32 個です。
lookup-cli-command	command	bin/magento コマンドの説明、使用方法、引数、オプションを返します。短縮形（s:up）やキーワードも受け付けます。
lookup-webapi	query, api?, method?, limit?	REST エンドポイント（パラメーター、本文、呼び出しに使用するトークン）と、GraphQL のクエリおよびミューテーション（引数、戻り値、例、ガイド）を返します。

スキャフォールディング

ツール	パラメーター	生成する内容
scaffold-module	module, description?, packageName?, version?, license?, sequence?, php?, basePath?	registration.php、etc/module.xml、composer.json。
add-plugin	module, targetClass, method, type, pluginClass?, pluginName?, area?, sortOrder?, basePath?	プラグイン（before、after、around）のクラスと、その di.xml。
add-observer	module, event, observerClass?, observerName?, area?, basePath?	observer クラスと、その events.xml。
add-controller	module, area, frontName, routeId?, controller?, action?, method?, title?, aclResource?, basePath?	routes.xml と controller（GET ページまたは POST による JSON）。ページの場合は、layout と template も生成します。adminhtml では、ADMIN_RESOURCE と acl.xml も生成します。
add-db-schema	module, table, columns?, primaryKey?, unique?, indexes?, foreignKeys?, comment?, resource?, engine?, basePath?	etc/db_schema.xml 内のテーブルと、whitelist および setup:upgrade の手順。
scaffolding ツールは、files（path、content、source）と notes を含む structuredContent も返します。パスはインストールルート（デフォルトでは app/code/<Vendor>/<Module>）からの相対パスです。ツールはモジュールの内容を確認できないため、ファイルがすでに存在する場合、新しいノードは既存の内容とマージされ、その旨が notes に記載されます。

リソース

URI	内容
adobe-commerce://docs	領域とフォルダー別のドキュメントインデックス。
adobe-commerce://docs/{id}	ページ。例：adobe-commerce://docs/php/development/components/plugins.md。
adobe-commerce://config-files	カタログ内の設定ファイル一覧。
adobe-commerce://sources	データのリポジトリ、コミット、ライセンス。

データの出所

すべてのデータは、data/fonte.json で指定されたコミットの Adobe Commerce 公開ドキュメントリポジトリから取得しています。

リポジトリ	ライセンス	提供内容
AdobeDocs/commerce-php	Apache-2.0	807 ページ：PHP 拡張機能、アーキテクチャ、チュートリアル、コード標準、モジュールリファレンス。
AdobeDocs/commerce-frontend-core	Apache-2.0	262 ページ：テーマ、レイアウト、テンプレート、UI コンポーネント、JavaScript、Page Builder。
AdobeDocs/commerce-webapi	Apache-2.0	REST と GraphQL のガイド 532 ページ、OpenAPI 2.4.9 スキーマ、生成された GraphQL 2.4.9 リファレンス。
AdobeDocs/commerce-operations.en	MIT	295 ページ：設定、CLI、インストール、パフォーマンス、セキュリティ、アップグレード、bin/magento リファレンス。

リリースノート、Quality Patches Tool のパッチページ 900 件以上、クラウド監視ツール、以前のバージョンの GraphQL リファレンスは含まれていません。magento/magento2 のコードと XSD は使用していません。ライセンス（OSL-3.0）がこのパッケージの MIT ライセンスと互換性がないためです。scaffolding テンプレートは、ドキュメントの例を参考に調整しました。

ソースのライセンスは data/licenses/ に、詳細は NOTICE に記載されています。このプロジェクトは Adobe と提携しておらず、Adobe の承認も受けていません。

構成

src/
├── index.ts            # entry point del binario (stdio)
├── server.ts           # McpServer: registra tools y resources
├── tools/              # una herramienta por archivo, registradas en tools/index.ts
├── scaffold/           # validación de nombres y formato de los archivos generados
├── resources/          # adobe-commerce://docs, config-files y sources
└── knowledge/          # carga de data/ y búsqueda BM25
scripts/
├── ingerir.ts          # genera data/ a partir de los clones de AdobeDocs
├── catalogo-config.ts  # catálogo de archivos de configuración, con sus fuentes
├── probar-mcp.mjs      # arranca el servidor por stdio y comprueba las herramientas
└── rastros.mjs         # busca rutas locales, correos personales y nombres de clientes
data/                   # generado: docs, cli.json, webapi/, config-files.json, licencias
test/                   # node --test sobre el build

開発

npm install
npm run check

コマンド	内容
npm run build	TypeScript を build/ にコンパイルし、バイナリに実行権限を付与します。
npm run lint	src/ と scripts/ の型チェックを行います。
npm test	ビルドに対して node --test でテストを実行します。
npm run probar-mcp	コンパイル済みサーバーを stdio で起動し、想定されるツールが不足している場合は失敗します。
npm run rastros	node_modules の外でローカルパス、個人メールアドレス、顧客名を検索します。
npm run check	ゲートです。prettier --check、lint、ビルド、テスト、probar-mcp、rastros を実行します。
npm run ingerir -- <carpeta>	クローンから data/ を再生成します（FONTES_DIR でも指定できます）。
npm run inspect	ビルドに対して MCP Inspector を起動します。

クライアントでローカル版をテストするには、コマンドの参照先をビルドにします。

claude mcp add adobe-commerce-local -- node /ruta/a/adobe-commerce-mcp/build/index.js

規約：TypeScript の ESM モジュールを使用し、Prettier はセミコロンなし、シングルクォートを使用します。ツールの説明は英語です。モデルがツールを選択する際に読むためです。実行時のナレッジは読み取り専用です。ディスクへの書き込みやダウンロードは行いません。

ドキュメントの更新

1. AdobeDocs/commerce-php、commerce-frontend-core、commerce-webapi、commerce-operations.en を同じフォルダーにクローンします（浅いクローンで十分です）。
2. npm run ingerir -- <carpeta> を実行します。このスクリプトはテキストファイルのみを読み込み、クローンの内容を実行することはありません。
3. 設定カタログの項目に、存在しないページまたはソース内に見つからない URN が記載されている場合、取り込みは失敗します。
4. npm run check を実行し、data/ をコミットします。このパッケージで必要です。

ブランチと公開

作業は dev から作成したブランチで行い、PR の対象は dev です。そこから qa に昇格し、テスト後に main に昇格します。いずれもブランチ全体をマージします。CI は Node 18、20、22 で npm run check を実行します。

公開するには、package.json、server.json、CHANGELOG.md のバージョンを更新し、v* タグをプッシュします。publish.yml ワークフローがゲートを実行し、provenance 付きで npm に公開し、GitHub Release を作成して、server.json を MCP Registry に公開します。各バージョンの変更内容は CHANGELOG.md に記載されています。

貢献 · ライセンス

Conventional Commits に従い、npm run check が成功する状態で、dev を対象に PR を作成してください。

MIT。data/ のデータには各ソースのライセンス（Apache-2.0 および MIT）が適用されます。NOTICE をご確認ください。

---

commente.me 制作 · [email protected]