`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、ファイル、データベースからリアルタイムデータにアクセスする
ビジネスプロセスの自動化（例：注文処理、価格更新）
安全かつ制御された方法で外部サービスとやり取りする

🚀 メデューサ JS + MCP

medusa-mcpを使用すると、Medusa JS は次のことが可能になります。

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

✨ 特徴

✅モデルコンテキストプロトコル（MCP）のサポート
📈スケーラブルなインフラストラクチャ
🧱拡張可能なプラグインアーキテクチャ
🔗 Medusa JS SDK と統合

🛠️ インストール

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

npm install

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

npm run build

▶️ 使用方法

サーバーを起動します。

npm start

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

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

**注:**再構築するたびに、インスペクターとブラウザを再起動してください。

🌍 環境変数

変数	説明
`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 – 管理エンドポイント
- store.json – ストアフロントのエンドポイント

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

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

🤝 貢献する

貢献を歓迎します！ CONTRIBUTING.mdガイドをご覧ください。

📄 ライセンス

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

Medusa MCP Server

Integrations