Yangotech MCP

🚀 Yango Tech MCPサーバー - 1コマンドインストール

このプロジェクトは、eコマース自動化のリーディングプラットフォームである**Yango Tech**との統合を提供します。

Yango Techは、世界中の人々の日常のビジネスを変革するグローバルテック企業であるYango Groupの一部です。

📊 2018年以降1億5000万回以上の乗車
💰 25億ドル以上の総取引額
✅ 99.99% の注文が品物を欠品することなく配達
📦 130万件以上の日々の注文

Yango Techは、以下の包括的なソリューションを提供します。

• 🌐 APPウェブサイトアプリケーション
• 🏪 注文管理と物流
• 📦 リアルタイム在庫管理
• 🛍️ 詳細情報を含む商品カタログ化
• 🚚 配達と注文履行
• 📊 分析と販売レポート
• 🔄 B2B自動化のためのAPI統合

このMCPサーバーを通じて、Claude DesktopまたはCursor IDEから直接Yango Tech APIと簡単にやり取りでき、注文、商品、在庫レベル、その他のプラットフォーム情報にアクセスできます。

🚀 クイックスタート

ユーザー向け - 簡単なインストール

このプロジェクトをダウンロードし、1つのコマンドを実行します。

python3 install.py

完了！すべてが自動的に設定されます。🎉

インストーラーの機能

1. ✅ OSを自動検出 (Mac/Windows/Linux)
2. ✅ Pythonを見つけ、仮想環境を作成
3. ✅ すべての依存関係を自動的にインストール (FastMCP 2.5+を含む)
4. ✅ インストールされたIDEを検出 (Claude Desktop & Cursor IDE)
5. ✅ テスト用のAPIキーを提供するか、独自のキーを使用
6. ✅ IDEの設定を自動的に作成 (IDEがインストールされている場合)
7. ✅ 手動設定用の設定ファイルをプロジェクトルートに生成
8. ✅ 実際のAPIで機能をテスト
9. ✅ 次のステップの指示を表示

💡 IDEがインストールされていなくても動作します - 設定ファイルは常に生成されます！

✨ 主な機能

🎯 強力なIDE統合

🤖 Claude Desktop & Cursor IDE 対応！

インストール後、以下とのシームレスな統合が可能になります。

🖥️ Claude Desktop

Yango Techの機能を備えたプロフェッショナルなAIアシスタント

• 💬 Yango Tech APIへの自然言語クエリ
• 🔍 読みやすい名前でのスマートな商品検索
• 📋 会話を通じた注文管理
• 📊 リアルタイム在庫チェック

📸 Claude Desktopの実際の動作を見る:

🛍️ 商品カタログ分析:

🎬 ライブ商品検索デモ:

📦 在庫管理:

📋 注文詳細検索:

🔍 注文ステータス追跡:

⚡ Cursor IDE

ビジネスデータにアクセス可能なAI搭載のコードエディター

• 🛠️ Yango Techのデータをクエリしながらコードを記述
• 🔄 ワークフロー内で直接APIを統合
• 📝 実データを使用したドキュメント生成
• 🚀 ライブビジネスインサイトを用いた迅速なプロトタイピング

🎨 これが画期的な理由:

複数のツール間を切り替える代わりに、以下が可能です。

• ✨ Claudeに質問: "注文240920 - 728268の詳細を表示して"
• ✨ Cursorに質問: "店舗L001の在庫が少ない商品は何ですか？"
• ✨ 読みやすい商品名で即座に回答を得る
• ✨ 複雑なAPI呼び出しではなく自然言語でより迅速に作業する

🔗 すべてがYango Tech - あなたのeコマース自動化プラットフォームによって提供されます！

インストール後の手順

1. Claude Desktopおよび/またはCursor IDEを再起動 (インストールされている場合)
2. 商品名が充実した6つのYango Techツールが利用可能になります
   • get_order_details - 商品名付きで注文詳細を取得
   • get_order_status - 注文ステータスを取得
   • get_all_products - 表示名付きですべての商品を取得
   • get_products_batch - ページネーションと商品名付きで商品を取得
   • get_all_stocks - 商品名付きですべての在庫を取得
   • get_stocks_batch - ページネーションと商品名付きで在庫を取得

🎯 主な特徴: すべてのツールは、暗号化された商品IDではなくユーザーフレンドリーな商品名を表示します！

📁 生成された設定ファイル

インストーラーは常にプロジェクトルートに以下のファイルを作成します。

• claude_desktop_config.json - すぐに使えるClaude Desktopの設定
• cursor_settings.json - すぐに使えるCursor IDEの設定

これらのファイルは以下の用途に使用できます。

• 手動でのIDE設定
• 設定のバックアップ
• 他のマシンへの設定のコピー
• トラブルシューティング

🧪 Claude DesktopとCursor IDEのテストコマンド

• "Yango Techのカタログから5つの商品を表示" (商品名付き)
• "店舗内の商品在庫を表示" (商品名付き)
• "注文240920 - 728268の詳細を表示" (充実したカートアイテム付き)
• "注文240920 - 728268のステータスを取得"

⚙️ 必要条件

• Python 3.8+ (自動的に検出および検証されます)
• 依存関係をダウンロードするためのインターネット接続
• Claude Desktopおよび/またはCursor IDE (オプション - 設定ファイルは常に生成されます)

🐍 Pythonがインストールされていない場合

問題ありません！Pythonがない場合、または古いバージョンの場合は、インストーラーが詳細なインストールガイドを表示します。

• macOS: 公式インストーラー、Homebrew、またはpyenv
• Windows: 公式インストーラー (⚠️ "PATHに追加"をチェック)、Microsoft Store、またはChocolatey
• Linux: パッケージマネージャ (apt, dnf, pacman) またはソースから

なぜPython 3.8+が必要なのか？ FastMCPフレームワークとの互換性のためです。

簡単なチェック: python3 --version または python --version を実行

📖 詳細ガイド: PYTHON_SETUP.md を参照して、手順を確認してください。

🧹 環境の完全リセット

完全にクリーンアップして再インストールする必要がある場合は、以下のコマンドを実行します。

python3 cleanup.py
python3 install.py

クリーンアップスクリプトは以下を削除します。

• 仮想環境
• 両方のIDEの設定ファイル
• 生成された設定ファイル
• 環境ファイル
• キャッシュファイル

🌍 APIエンドポイント

• テスト環境: https://api.tst.eu.cloudretail.tech
• 本番環境: https://api.retailtech.yango.com

🔧 技術詳細

プロジェクトアーキテクチャ

yangotech_mcp/
├── install.py               # 🎯 汎用インストーラー
├── cleanup.py               # 🧹 完全なクリーンアップスクリプト
├── server.py                # FastMCPサーバー
├── client.py                # Yango Tech APIのHTTPクライアント
├── models.py                # Pydanticデータモデル
├── claude_desktop_config.json  # 生成されたClaudeの設定
├── cursor_settings.json        # 生成されたCursorの設定
└── README.md                # このドキュメント

開発用インストール

# 仮想環境を作成
python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
# または
.venv\Scripts\activate     # Windows

# 依存関係をインストール (現在はFastMCP 2.5+を含む)
pip install -e .

# APIをテスト
export YANGO_TECH_API_KEY="your_api_key"
python test_api_connection.py

# MCPサーバーを実行
python server.py

技術スタック

• FastMCP 2.5+: 最新のMCPサーバーフレームワーク
• Python 3.8+: コア言語
• HTTPx: 非同期HTTPクライアント
• Pydantic: データ検証
• python-dotenv: 環境管理

APIエンドポイント

サーバーは実際のYango Tech APIと連携します。

• テストURL: https://api.tst.eu.cloudretail.tech/b2b/v1
• 本番URL: https://api.retailtech.yango.com/b2b/v1
• 認証: ヘッダー内のOAuthトークン
• メソッド: ほとんどのリクエストにPOST
• ページネーション: 大量データにはカーソルベース

IDEサポート

• Claude Desktop: mcpServers設定を使用
• Cursor IDE: mcp.servers設定を使用
• 自動検出: インストーラーがインストールされているIDEを検出
• 汎用性: IDEがなくても動作 - 設定ファイルは常に生成されます

📞 サポート

何かがうまくいかない場合は、以下の手順を試してください。

1. Pythonを確認: python3 --version (3.8+である必要があります)
2. 完全なリセット: python3 cleanup.py && python3 install.py
3. 手動設定: 生成された設定ファイル (claude_desktop_config.json, cursor_settings.json) を使用
4. 手動設定ガイド: MANUAL_SETUP.md を参照して詳細な手順を確認
5. IDEのログを確認 (Claude DesktopまたはCursor IDE)
6. インストール後にIDEを再起動していることを確認

🎯 目標: 1つのコマンドで、Claude DesktopとCursor IDEの両方ですべてが動作する (または手動設定用の設定ファイルを生成する)！