Magento 2 MCP Server

Magento 2 MCP サーバー

Magento 2 向けの Model Context Protocol（MCP）サーバー実装です。標準化されたインターフェースを通じて、AI アシスタントが Magento ストアとやり取りできるようにします。

特長

• Magento 2 との REST API 連携
• 安全な認証処理
• Magento の一般的な操作に対応するリソースハンドラーとツールハンドラー
• 型安全性を実現する TypeScript 実装
• 公式 MCP SDK を基盤に構築

前提条件

• Node.js（v18 以降）
• npm（v8 以降）
• REST API にアクセスできる Magento 2 インスタンス
• Magento の管理 API アクセストークン

インストール

npm install vasileuski/magento2-mcp-server

使用方法

サーバーの起動

magento <magento_url> <admin_api_token>

例：

magento https://your-magento-store.com eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

MCP クライアントとの連携

このサーバーを MCP クライアント（Cursor など）で使用するには、次の設定をクライアントの設定に追加します。

{
  "tools": [
    {
      "name": "mcp_magento_magento_rest_api",
      "command": "magento https://your-magento-store.com your-admin-api-token"
    }
  ]
}

これにより、以下の機能を利用できます。

• Magento インスタンスへの REST API アクセス
• スキーマのイントロスペクション
• リソースの一覧表示と読み取り
• Magento の一般的な操作のツール実行

利用可能なツール

magento_rest_api

Magento インスタンスに REST API リクエストを送信します。

パラメーター：

• path：API エンドポイントのパス
• method：HTTP メソッド（GET、POST、PUT、DELETE）
• body：リクエスト本文（JSON 文字列）
• query：クエリパラメーター

MCP クライアントでの使用例：

const response = await mcp.magento_rest_api({
  path: "rest/V1/orders",
  method: "GET",
  body: "",
  query: "searchCriteria[pageSize]=3&searchCriteria[currentPage]=1"
});

開発

1. リポジトリをクローンします
2. 依存関係をインストールします：npm install
3. 開発サーバーを起動します：npm run dev
4. 変更を加えます
5. テストを実行します：npm test
6. 本番環境向けにビルドします：npm run build

セキュリティ

• Magento の管理者トークンを決してコミットしないでください
• 機密情報には環境変数を使用してください
• Node.js と npm のバージョンを最新の状態に保ってください
• 依存関係を定期的に更新してください

ライセンス

MIT