Magento2 MCP Server

🚀 Magento 2 MCP サーバー

このサーバーは、Magento 2 用に実装された Model Context Protocol (MCP) サーバーです。AI アシスタントが標準化されたインターフェースを通じて、Magento ストアと相互作用できるようにします。

✨ 主な機能

• Magento 2 の REST API との統合
• 安全な認証処理
• 一般的な Magento 操作のリソースとツールハンドラー
• TypeScript を使用した型安全な実装
• 公式 MCP SDK に基づく開発

📦 インストール

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 へのアクセス
• スキーマイントロスペクション（introspection）
• リソースのリスト表示と読み取り
• 一般的な Magento 操作のツール実行

基本的な使用法

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

📚 ドキュメント

利用可能なツール

magento_rest_api

Magento インスタンスに REST API リクエストを送信します。 パラメータ：

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

開発

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

セキュリティ

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

📄 ライセンス

MIT