Yangotech MCP

🚀 Yango Tech MCP Server - One Command Installation

This project offers seamless integration with Yango Tech, a leading platform for ecommerce automation.

Yango Tech, a part of Yango Group, is a global tech company revolutionizing daily business operations worldwide:

📊 Over 150 million rides since 2018
💰 More than $2.5 billion in GMV
✅ A 99.99% order delivery rate without missing items
📦 Over 1.3 million daily orders

Yango Tech provides comprehensive solutions for:

• 🌐 APP Website applications
• 🏪 Order management and logistics
• 📦 Real-time inventory management
• 🛍️ Product cataloging with detailed information
• 🚚 Delivery and order fulfillment
• 📊 Analytics and sales reporting
• 🔄 API integration for B2B automation

Through this MCP server, you can interact directly with the Yango Tech API from Claude Desktop or Cursor IDE, accessing orders, products, stock levels, and other platform information.

🚀 Quick Start

📦 Installation

Download this project and execute the following command:

python3 install.py

Once done, everything will be configured automatically. 🎉

🛠️ What the Installer Does

1. ✅ Automatically detects your OS (Mac/Windows/Linux).
2. ✅ Locates Python and creates a virtual environment.
3. ✅ Installs all dependencies automatically (including FastMCP 2.5+).
4. ✅ Detects installed IDEs (Claude Desktop & Cursor IDE).
5. ✅ Offers a test API key or allows you to use your own.
6. ✅ Automatically creates IDE configurations (if IDEs are installed).
7. ✅ Generates config files in the project root for manual setup.
8. ✅ Tests functionality with the real API.
9. ✅ Displays instructions for the next steps.

💡 The installer works even without IDEs installed as configuration files are always generated.

✨ Features

🤖 Integration with Claude Desktop & Cursor IDE

After installation, you'll enjoy seamless integration with:

🖥️ Claude Desktop

A professional AI assistant powered by Yango Tech:

• 💬 Send natural language queries to the Yango Tech API.
• 🔍 Conduct smart product searches with readable names.
• 📋 Manage orders through conversations.
• 📊 Check real-time inventory.

📸 See Claude Desktop in Action:

• 🛍️ Product Catalog Analysis:
• 🎬 Live Product Search Demo:
• 📦 Inventory Management:
• 📋 Order Details Lookup:
• 🔍 Order Status Tracking:

⚡ Cursor IDE

An AI-powered code editor with access to business data:

• 🛠️ Write code while querying Yango Tech data.
• 🔄 Integrate the API directly into your workflow.
• 📝 Generate documentation with real data.
• 🚀 Rapidly prototype with live business insights.

🎨 Why This Is Game-Changing

Instead of switching between multiple tools, you can:

• ✨ Ask Claude: "Show me details for order 240920-728268".
• ✨ Ask Cursor: "What products are low in stock at store L001?".
• ✨ Get instant answers with human-readable product names.
• ✨ Work faster using natural language instead of complex API calls.

🔗 All powered by Yango Tech, your ecommerce automation platform!

📁 Generated Configuration Files

The installer creates the following files in the project root:

• claude_desktop_config.json: Ready-to-use Claude Desktop configuration.
• cursor_settings.json: Ready-to-use Cursor IDE configuration.

Use these files for manual IDE setup, backup configurations, copying settings to other machines, or troubleshooting.

🧪 Test Commands for Claude Desktop & Cursor IDE

• "Show 5 products from Yango Tech catalog" (with product names).
• "Show product stocks in stores" (with product names).
• "Show details of order 240920-728268" (with enriched cart items).
• "Get order status for 240920-728268".

⚙️ Requirements

• Python 3.8+: Automatically detected and verified.
• Internet: Required for downloading dependencies.
• Claude Desktop and/or Cursor IDE (optional; configs are generated regardless).

🐍 Don't have Python installed?

No worries! If Python is missing or too old, the installer provides detailed installation guides:

• macOS: Use the official installer, Homebrew, or pyenv.
• Windows: Use the official installer (⚠️ check "Add to PATH"), the Microsoft Store, or Chocolatey.
• Linux: Use the package manager (apt, dnf, pacman) or install from source.

Why Python 3.8+? It's required for FastMCP framework compatibility.

Quick check: Run python3 --version or python --version. 📖 Detailed guide: See PYTHON_SETUP.md for step-by-step instructions.

🧹 Complete Environment Reset

If you need to completely clean and reinstall, run the following commands:

python3 cleanup.py
python3 install.py

The cleanup script removes the virtual environment, configuration files from both IDEs, generated configuration files, environment files, and cache files.

🌍 API Endpoints

• Test Environment: https://api.tst.eu.cloudretail.tech
• Production Environment: https://api.retailtech.yango.com

🔧 Technical Details

Project Architecture

yangotech_mcp/
├── install.py               # 🎯 Universal installer  
├── cleanup.py               # 🧹 Complete cleanup script
├── server.py                # FastMCP server
├── client.py                # HTTP client for Yango Tech API
├── models.py                # Pydantic data models
├── claude_desktop_config.json  # Generated Claude config
├── cursor_settings.json        # Generated Cursor config
└── README.md                # This documentation

Development Installation

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
# or
.venv\Scripts\activate     # Windows

# Install dependencies (now includes FastMCP 2.5+)
pip install -e .

# Test API
export YANGO_TECH_API_KEY="your_api_key"
python test_api_connection.py

# Run MCP server
python server.py

Technology Stack

• FastMCP 2.5+: Modern MCP server framework.
• Python 3.8+: Core language.
• HTTPx: Async HTTP client.
• Pydantic: Data validation.
• python-dotenv: Environment management.

API Endpoints

The server interacts with the real Yango Tech API:

• Test URL: https://api.tst.eu.cloudretail.tech/b2b/v1
• Production URL: https://api.retailtech.yango.com/b2b/v1
• Authorization: OAuth token in the header.
• Methods: POST for most requests.
• Pagination: Cursor-based for large data.

IDE Support

• Claude Desktop: Uses mcpServers configuration.
• Cursor IDE: Uses mcp.servers configuration.
• Auto-detection: The installer detects which IDEs are installed.
• Universal: Works without IDEs as configs are always generated.

📞 Support

If something goes wrong:

1. Check Python: Run python3 --version (should be 3.8+).
2. Complete reset: Run python3 cleanup.py && python3 install.py.
3. Manual setup: Use the generated config files (claude_desktop_config.json, cursor_settings.json).
4. Manual setup guide: Refer to MANUAL_SETUP.md for detailed instructions.
5. Check IDE logs (Claude Desktop or Cursor IDE).
6. Ensure IDEs are restarted after installation.

🎯 Goal: With a single command, everything will work in both Claude Desktop and Cursor IDE (or configs will be generated for manual setup)!