Medusa Mcp

medusa-mcp

概要

medusa-mcp は、Medusa JavaScript SDK との統合を目的として設計された Model Context Protocol (MCP) サーバーです。Medusa のデータモデルを管理および操作するためのスケーラブルなバックエンドレイヤーを提供し、自動化、オーケストレーション、インテリジェントなサービス拡張を可能にします。

---

🧩 MCP サーバーとは？

MCP サーバーとは、モジュール式で拡張可能なバックエンドであり、次のことを実現します。

• リアルタイムのサービスオーケストレーションを可能にします
• 標準化された高スループット通信をサポートします
• AI／自動化ツールと実システムの間のブリッジとして機能します

これらのサーバーは、AI、IoT、エンタープライズソフトウェアなどの分野で使用され、JSON-RPC などの標準化されたプロトコルを使用してさまざまなサービスを接続し、タスクを自動化します。

🔑 主な機能

• モジュール式アーキテクチャ – 柔軟性を実現するコンポーザブルなサービス
• 高い効率性 – 速度とスケールに最適化
• 拡張可能な設計 – 新しい機能を簡単に追加
• クロス環境デプロイ – クラウド、オンプレミス、またはハイブリッド
• AI 対応インターフェース – LLM とツールをシームレスに統合

🧠 AI システムにおける役割

MCP サーバーにより、AI エージェントは次のことが可能になります。

• API、ファイル、データベースからリアルタイムデータにアクセスする
• ビジネスプロセス（例：注文処理、価格更新）を自動化する
• 外部サービスと安全かつ制御された方法で連携する

---

---

🚀 Medusa JS + MCP

medusa-mcp を使用すると、Medusa JS は次のことができます。

• ワークフローを自動化する（例：在庫や価格の調整）
• 外部ツール（メール、分析など）と連携する
• AI エージェントを使用してトレンドを分析し、アクションをトリガーする
• コマースプラットフォーム向けのスケーラブルでモジュール式のアーキテクチャを実現する

---

✨ 機能

• ✅ Model Context Protocol (MCP) のサポート
• 📈 スケーラブルなインフラストラクチャ
• 🧱 拡張可能なプラグインアーキテクチャ
• 🔗 Medusa JS SDK との統合

---

🛠️ インストール

リポジトリをクローンし、依存関係をインストールします。

npm install

プロジェクトをビルドします。

npm run build

---

▶️ 使用方法

サーバーを起動します。

npm start

MCP Inspector を使用してテストします。

npx @modelcontextprotocol/inspector ./dist/index.js

Note: 再ビルドするたびに、Inspector とブラウザを再起動してください。

---

🛠️ この MCP サーバーから Claude Skill を生成する

mcp-to-skill-converter プロジェクトの mcp-to-skill.py スクリプトを使用して、この MCP サーバーを Claude Skill に変換できます。このスクリプトは、このリポジトリに mcp-to-skill.py として含まれています。

1. MCP サーバーをビルドします（設定内のコマンドが機能するようにするため）：

   npm run build
   

2. Python と mcp パッケージが利用可能であることを確認します：

   pip install mcp
   

3. 提供されている mcp-to-skill.json 設定を使用して、このサーバー用の Skill を生成します：

   python mcp-to-skill.py --mcp-config mcp-to-skill.json --output-dir ./skills/medusa-mcp
   

   これにより、以下が作成されます。

   • SKILL.md – Claude 向けの手順
   • executor.py – MCP 通信ハンドラー
   • mcp-config.json – MCP サーバー設定
   • package.json – スキルの最小限の依存関係

4. Claude 用に Skill をインストールします：

   cd skills/medusa-mcp
   pip install mcp
   cp -r . ~/.claude/skills/medusa-mcp
   

Claude は次回の起動時に新しい Skill を自動的に検出します。

---

🌍 環境変数

変数	説明
MEDUSA_BACKEND_URL	Medusa バックエンドの URL
PUBLISHABLE_KEY	Medusa の公開可能な API キー
MEDUSA_USERNAME	Medusa 管理者ユーザー名（管理者用）
MEDUSA_PASSWORD	Medusa 管理者パスワード（管理者用）

サーバーは次の場所で実行されます：http://localhost:3000

---

🧠 アーキテクチャ図

以下は、medusa-mcp サーバーが Medusa JS および外部システムとの典型的な構成にどのように適合するかを示しています。

       +-------------------------+
       |     AI Assistant /      |
       |     LLM / Automation    |
       +-----------+-------------+
                   |
                   v
    +--------------+--------------+
    |     MCP Server (medusa-mcp) |
    |-----------------------------|
    | - JSON-RPC Communication    |
    | - AI-Ready Interface        |
    | - Plugin Support            |
    +------+----------------------+
                   |                             
                   +
                   |                                                         
                   v                                                         
         +-------------------+
         | Medusa Backend    |
         | (Products, Orders)|
         +-------------------+
                   |
                   |
                   v
           +--------------+
           | Medusa Store |
           | Frontend     |
           +--------------+
                   |
                   |
                   v
      +-------------------------+
      | External Services / API |
      | (e.g., Payments, Email) |
      +-------------------------+

🧪 カスタマイズ

サーバーをあなたの Medusa 環境に合わせて調整するには：

きめ細かな制御を行うには、admin.json と store.json を独自の OAS 定義に置き換えてください。

• oas/ フォルダー内の OpenAPI スキーマを置き換えます：
  • admin.json – Admin エンドポイント
  • store.json – ストアフロントエンドポイント

これらのファイルを再生成するには、@medusajs/medusa-oas-cli を使用します。

また、このプロジェクトをフォークして、独自のカスタム MCP 搭載の Medusa 連携を構築することもできます。

---

🤝 コントリビューション

コントリビューションを歓迎します！　詳しくは CONTRIBUTING.md ガイドをご覧ください。

---

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。