🛍️ MCP - MCP for Commerce Platforms - Universal E-commerce Customer Support Assistant

---

title: Enneagora - E-commerce MCP サーバー emoji: 🛍️ colorFrom: blue colorTo: purple sdk: gradio sdk_version: 5.33.0 app_file: main.py pinned: true license: mit tags:

• mcp-server-track
• cuustomer support
• commerce
• e-commerce

---

Enneagora - E-commerce MCP サーバー

Enneagora は、Model Context Protocol（MCP）を使用する汎用 E コマースカスタマーサポートアシスタントです。さまざまな E コマースプラットフォームで利用できる、プラットフォームに依存しないカスタマーサポートソリューションを提供します。この包括的な MCP サーバーは、Claude Desktop または MCP 互換クライアントと連携し、あらゆる種類のお問い合わせに対応できます。

🚀 特長

• MCP 準拠：SSE および STDIO トランスポートを使用する、Gradio と FastMCP による二重の MCP サーバー実装
• 包括的なカスタマーサポートツール 14 種：
  • 注文管理：get_order_status、cancel_order、process_return、track_package
  • サポート情報：get_support_info、get_return_policy、get_shipping_info、get_contact_information
  • 製品ガイダンス：get_size_guide、get_warranty_information、get_product_care_info
  • アカウントと支払い：get_payment_information、get_account_help、get_loyalty_program_info
• プラットフォーム非依存：あらゆる E コマースプラットフォームと簡単に連携できるストラテジーパターン
• 動的なモックデータ：パターンベースの注文動作を備えたインテリジェントなテストデータシステム
• 二重の実装をサポート：ウェブへのデプロイには Gradio MCP サーバー、Claude Desktop の STDIO 連携には FastMCP を使用
• 本番環境対応：Hugging Face Spaces への自動デプロイを備えた CI/CD パイプライン

📋 前提条件

• Python 3.10 以上
• pip パッケージマネージャー
• （任意）デプロイ用の Hugging Face アカウント

🛠️ インストール

1. リポジトリをクローンします。

git clone https://github.com/slavpilus/mcp.git
cd mcp

2. 仮想環境を作成して有効化します。

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

🚀 使用方法

オプション 1：Gradio MCP サーバー（Hugging Face Spaces での利用を推奨）

Hugging Face Spaces でホストされている Gradio MCP サーバーを使用します。

Gradio MCP エンドポイント： https://huggingface.co/spaces/SlavPilus/mpc-for-commerce-platforms

利点：

• mcp_server=True を使用したネイティブな Gradio MCP サーバー実装
• ローカルでのセットアップ不要
• 常に最新の機能を利用可能
• MCP 互換クライアントや連携に最適
• Hugging Face Spaces へのシームレスなデプロイ

Gradio MCP サーバー（ローカル開発）

python main.py

Gradio MCP サーバーは http://localhost:7860 で起動し、MCP SSE エンドポイントは http://localhost:7860/gradio_api/mcp/sse で利用できます。

FastMCP と Claude Desktop の連携（STDIO）

ステップ 1：Claude Desktop を設定する

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。 Windows： %APPDATA%\Claude\claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "enneagora": {
      "command": "python",
      "args": ["/full/absolute/path/to/mcp/main_stdio.py"],
      "env": {}
    }
  }
}

⚠️ 重要：

• main_stdio.py には絶対パスを指定してください。
• Python 環境にすべての依存関係がインストールされていることを確認してください。
• 設定を変更した後は、Claude Desktop を再起動してください。

ステップ 2：設定をテストする

STDIO 版は手動でテストできます。

python main_stdio.py

🔧 利用可能なすべてのツール

注文管理ツール

1. get_order_status - 注文の詳細な状況と追跡情報を取得します。
2. cancel_order - 検証チェックを行って注文をキャンセルします。
3. process_return - 料金前払いのラベルを使って返品リクエストに対応します。
4. track_package - リアルタイムの更新情報を使って荷物の配送状況を追跡します。

情報・サポートツール

5. get_support_info - 一般的なサポート情報とガイダンスを提供します。
6. get_return_policy - 製品カテゴリ別の詳細な返品ポリシーを提供します。
7. get_shipping_info - 配送料、配送日数、海外配送のオプションを提供します。
8. get_contact_information - 問題の種類や緊急度に応じた連絡先情報を提供します。

製品・サービスツール

9. get_size_guide - 衣類、靴、アクセサリーのサイズ表を提供します。
10. get_warranty_information - 保証範囲と保証請求の処理に関する情報を提供します。
11. get_product_care_info - お手入れ方法とメンテナンスのガイダンスを提供します。

アカウントと支払いに関するツール

12. get_payment_information - 支払い方法、請求に関するヘルプ、トラブルシューティング
13. get_account_help - アカウントのトラブルシューティングとログインのサポート
14. get_loyalty_program_info - リワードプログラムの詳細と会員特典

🧪 動的なモックデータを使ったテスト

Enneagora は、注文の動作が ID のパターンによって決まる、インテリジェントなモックデータシステムを備えています。

注文ステータスのパターン

• ORD-XXXX-D - 配達済みの注文（例：ORD-1001-D）
• ORD-XXXX-S - 追跡情報付きの発送済み注文（例：ORD-1002-S）
• ORD-XXXX-T - 位置情報の更新がある輸送中の注文（例：ORD-1003-T）
• ORD-XXXX-P - 処理中の注文（例：ORD-1004-P）
• ORD-XXXX-R - 店頭受け取り可能な注文（例：ORD-1005-R）
• ORD-XXXX-C - キャンセル済みの注文（例：ORD-1006-C）
• ORD-XXXX-F - 失敗または問題のある注文（例：ORD-1007-F）
• ORD-XXXX-E - エラーまたは見つからない注文（例：ORD-1008-E）
• ORD-XXXX - 保留中の注文（接尾辞なし、例：ORD-1009）

クエリの例

Claude Desktop または MCP クライアントに接続すると、自然言語を使って次のように操作できます。

注文管理：

• 「注文 ORD-1001-S のステータスを確認して」
• 「もっと安い価格を見つけたので、注文 ORD-1004-P をキャンセルして」
• 「注文 ORD-1002-D を返品したいです。サイズが合いませんでした」

商品情報：

• 「電子機器の返品ポリシーを教えてください」
• 「45ドルの注文をカナダに発送する場合、送料はいくらですか？」
• 「メンズシャツのサイズガイドを教えてください」
• 「私のノートパソコンはまだ保証期間内ですか？2023-06-15 に購入しました」

アカウントと支払い：

• 「クレジットカードが拒否されました。どうすればよいですか？」
• 「パスワードを忘れました。リセットする方法を教えてください」
• 「ロイヤルティプログラムの仕組みを教えてください」

製品のお手入れ：

• 「シルクのドレスのお手入れ方法を教えてください」
• 「革靴をきれいにする最適な方法は何ですか？」

🏗️ アーキテクチャ

┌─────────────────────────────────────┐
│         MCP Clients                 │
│  (Claude Desktop, Web Clients)      │
└──────────────┬──────────────────────┘
               │ MCP Protocol Transport
┌──────────────▼──────────────────────┐
│      Dual MCP Implementation        │
│  • main.py (Gradio MCP Server)      │
│  • main_stdio.py (FastMCP STDIO)    │
├─────────────────────────────────────┤
│  14 MCP Tools:                      │
│  • Order Management (4 tools)       │
│  • Information & Support (4 tools)  │
│  • Product & Service (3 tools)      │
│  • Account & Payment (3 tools)      │
├─────────────────────────────────────┤
│   E-commerce Strategy Layer         │
│  • Mock Strategy (Demo/Testing)     │
│  • Shopify Strategy (Future)        │
│  • Magento Strategy (Future)        │
│  • WooCommerce Strategy (Future)    │
└─────────────────────────────────────┘

🚢 デプロイ

Hugging Face Spaces でホスト

サーバーはデプロイ済みで、次の場所からアクセスできます。

• Web UI： https://huggingface.co/spaces/SlavPilus/mpc-for-commerce-platforms
• SSE エンドポイント： https://huggingface.co/spaces/SlavPilus/mpc-for-commerce-platforms/sse

手動デプロイ

# Build Docker image
docker build -t enneagora .

# Run container
docker run -p 7860:7860 enneagora

独自のインスタンスをデプロイ

1. このリポジトリをフォークします
2. GitHub シークレットを設定します。
   • HF_TOKEN：Hugging Face トークン
   • HF_USERNAME：Hugging Face ユーザー名
   • HF_SPACE_NAME：Space の名前
3. デプロイを開始するには、main ブランチにプッシュします

🧪 開発

テストの実行

# Install dev dependencies
pip install -r requirements-dev.txt

# Run tests with coverage
pytest --cov=mcp_server --cov=main

# Run linting and formatting
pre-commit run --all-files

プロジェクト構成

mcp/
├── main.py                 # Gradio MCP server (mcp_server=True)
├── app.py                  # MCP tools for Gradio registration
├── main_stdio.py          # FastMCP server (STDIO transport for Claude Desktop)
├── mcp_server/            # Core server implementation
│   ├── server.py          # Main server logic
│   ├── mcp_tools.py       # All 14 MCP tool definitions
│   └── strategies/        # E-commerce platform strategies
│       ├── base.py        # Base strategy interface
│       └── mock_strategy.py # Mock data strategy
├── tests/                 # Comprehensive test suite
│   ├── unit/              # Unit tests (96%+ coverage)
│   └── integration/       # Integration tests
├── static/                # Web UI assets
│   └── index.html         # Server info and documentation page
├── requirements.txt       # Python dependencies
├── requirements-dev.txt   # Development dependencies
└── pyproject.toml         # Project configuration

🔧 設定

環境変数

現在はデモ用のモックデータを使用しています。本番環境では、次の項目を設定してください。

• ECOMMERCE_PLATFORM：使用するプラットフォーム（例：「shopify」、「magento」）
• プラットフォーム固有の認証情報（API キー、エンドポイントなど）

新しい E コマースプラットフォームの追加

1. mcp_server/strategies/ に新しいストラテジーを作成します。

from .base import EcommerceStrategy

class ShopifyStrategy(EcommerceStrategy):
    async def get_order(self, order_id: str):
        # Implement Shopify API integration
        pass

2. 設定にストラテジーを登録します
3. 認証情報とエンドポイントを設定します

📝 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルをご覧ください。

🤝 コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

🐛 トラブルシューティング

よくある問題

1. Claude Desktop にツールが表示されない

   • 設定ファイルのパスと構文を確認します
   • main_stdio.py への絶対パスを指定していることを確認します
   • Python 環境にすべての依存関係がインストールされていることを確認します
   • 設定を変更した後、Claude Desktop を再起動します

2. サーバーへの接続に関する問題

   • サーバーが正しいポートで実行されていることを確認します
   • ローカル開発ではファイアウォールの設定を確認します
   • SSE エンドポイントにアクセスできることを確認します

3. インポートエラーまたは依存関係の不足

   • 仮想環境を有効にします
   • pip install -r requirements.txt を実行します
   • Python 3.10 以降がインストールされていることを確認します

設定のテスト

ローカルのセットアップをテストします。

# Test STDIO version
python main_stdio.py

# Test SSE version
python main.py
# Then visit http://localhost:7860

📚 リソース

• プロジェクトリポジトリ： https://github.com/slavpilus/mcp
• MCP ドキュメント： Model Context Protocol
• FastMCP ドキュメント： FastMCP GitHub
• Hugging Face Spaces： HF Spaces ドキュメント

🏆 謝辞

Enneagora は、Hugging Face MCP Hackathon の一環として、包括的な AI を活用したカスタマーサポートシステムの構築における Model Context Protocol の可能性を示すために開発されました。MCP が AI アシスタントと実際の E コマース業務の間をどのように橋渡しできるかを紹介しています。

紹介している主な機能：

• 包括的なツールエコシステム（相互に連携する 14 個のツール）
• インテリジェントな動作パターンを備えた動的なモックデータ
• マルチトランスポート対応（SSE + STDIO）
• 本番環境対応のデプロイと CI/CD
• 型安全な実装と 96% 以上のテストカバレッジ