Magento2 MCP

🚀 Magento 2 MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、Magento 2 REST API に接続し、Claude やその他の MCP クライアントが Magento ストア内の製品情報を照会できるようにします。

✨ 主な機能

製品機能

• SKU または ID で製品情報を照会する
• 様々な基準を使って製品を検索する
• 製品のカテゴリを取得する
• 関連製品を取得する
• 製品の在庫情報を取得する
• 製品属性を取得する
• 属性コードと値を指定して製品属性を更新する
• フィルタリングとソートを伴う高度な製品検索

顧客機能

• メールアドレスで顧客のすべての購入済み製品を取得する

注文と収益機能

• 特定の日付範囲内の注文数を照会する
• 特定の日付範囲内の総収益を照会する
• 国でフィルタリングした特定の日付範囲内の収益を照会する
• 製品の販売統計情報（販売数量や最も売れた製品など）を取得する
• 相対日付表現（「今日」、「昨日」、「先週」、「今月」、「年初から現在まで」など）をサポートする
• 国コードと国名を使った国のフィルタリングをサポートする

📦 インストール

前提条件

• Node.js (v14 以上)
• REST API アクセス権を持つ Magento 2 インスタンス
• Magento 2 インスタンスの API キー

インストール手順

1. このリポジトリをクローンする
2. 依存関係をインストールする：

npm install

💻 使用例

サーバーを直接起動する

node mcp-server.js

テストクライアントを使ってテストする

node test-mcp-server.js

Claude Desktop と連携する

1. Node のパスを確認する：which node
2. 開発者設定に移動し、「編集設定」をクリックする。これにより JSON ファイルが開きます。
3. mcpServers 内に以下のコードを追加する：

    "magento2": {
      "command": "/path/to/your/node",
      "description": ""
    }

4. /path/to/your/node を実際の Node.js のパスに置き換える。

📚 詳細ドキュメント

利用可能なツール

• createMagentocommandTool：Magento コマンドを実行するための CLI ツールを作成する。
• healthCheckMCP：MCP サーバーのヘルスチェックを行い、正常に動作していることを確認する。
• productImportExport：製品のインポートとエクスポート機能を実現する。

サンプルクエリ

製品クエリの例

curl -X POST http://localhost:3000/magento/product-import-export \
-H "Content-Type: application/json" \
-d '{"action": "import", "products": ["SKU123", "SKU456"]}'

注文統計の例

curl -X POST http://localhost:3000/magento/orders \
-H "Content-Type: application/json" \
-d '{"startDate": "2023-01-01", "endDate": "2023-12-31"}'

開発に関する注意事項

SSL 証明書の検証

開発目的では、サーバーは SSL 証明書の検証をバイパスするように設定されています。本番環境では、有効な SSL 証明書を使用し、callMagentoApi 関数から httpsAgent の設定を削除してください。

新しいツールの追加

新しいツールを追加するには、既存のコードのパターンに従ってください。各ツールは以下のように定義されます。

1. 一意の名前
2. 説明
3. Zod を使った入力パラメータの検証
4. リクエストを処理してレスポンスを返す非同期処理関数

📄 ライセンス

ISC