🚀 Yango Tech MCP Server - One Command Installation
🛒 Yango Tech Integration
This project provides integration with Yango Tech - a leading platform for ecommerce automation.
Yango Tech is part of Yango Group, a global tech company that transforms the everyday business of people around the world:
📊 150m+ rides since 2018
💰 $2.5B+ GMV
✅ 99.99% orders delivered without missing items
📦 1.3M+ daily orders
Yango Tech offers 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 easily interact with the Yango Tech API directly from Claude Desktop or Cursor IDE, gaining access to orders, products, stock levels, and other platform information.
For Users - Simple Installation
Download this project and run one command:
Done! Everything will be configured automatically. 🎉
What the installer does:
✅ Automatically detects your OS (Mac/Windows/Linux)
✅ Finds Python and creates virtual environment
✅ Installs all dependencies automatically (including FastMCP 2.5+)
✅ Detects installed IDEs (Claude Desktop & Cursor IDE)
✅ Offers test API key or your own
✅ Creates IDE configurations automatically (if IDEs installed)
✅ Generates config files in project root for manual setup
✅ Tests functionality with real API
✅ Shows instructions for next steps
💡 Works even without IDEs installed - configuration files are always generated!
🎯 POWERFUL IDE INTEGRATION
🤖 Claude Desktop
After installation, you'll have seamless integration with:
🖥️ Claude Desktop
Professional AI assistant with Yango Tech powers
💬 Natural language queries to Yango Tech API
🔍 Smart product search with readable names
📋 Order management through conversation
📊 Real-time inventory checking
📸 See
🛍️ Product Catalog Analysis:
🎬 Live Product Search Demo:
📦 Inventory Management:
📋 Order Details Lookup:
🔍 Order Status Tracking:
⚡ Cursor IDE
AI-powered code editor with business data access
🛠️ Code while querying Yango Tech data
🔄 API integration directly in your workflow
📝 Documentation generation with real data
🚀 Rapid prototyping 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 : "What products are low in stock at store L001?"
✨ Get instant answers with human-readable product names
✨ Work faster with natural language instead of complex API calls
🔗 All powered by
After installation
Restart (if installed)
You'll have 6 Yango Tech tools with product name enrichment:
get_order_details
- Get order details with product namesget_order_status
- Get order statusget_all_products
- Get all products with display namesget_products_batch
- Get products with pagination and namesget_all_stocks
- Get all stocks with product namesget_stocks_batch
- Get stocks with pagination and names
🎯 Key Feature: All tools show user-friendly product names instead of cryptic product IDs!
📁 Generated Configuration Files
The installer always creates these files in the project root:
claude_desktop_config.json
- Ready-to-use Claude Desktop configurationcursor_settings.json
- Ready-to-use Cursor IDE configuration
Use these files for:
Manual IDE setup
Backup configurations
Copying settings to other machines
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 for downloading dependencies
Claude Desktop and/or Cursor IDE (optional - configs generated anyway)
🐍 Don't have Python installed?
No problem! If Python is missing or too old, the installer shows detailed installation guides:
macOS: Official installer, Homebrew, or pyenv
Windows: Official installer (⚠️ check "Add to PATH"), Microsoft Store, or Chocolatey
Linux: Package manager (
apt
,dnf
,pacman
) or from source
Why Python 3.8+? 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:
The cleanup script removes:
Virtual environment
Configuration files from both IDEs
Generated configuration files
Environment files
Cache files
🌍 API Endpoints
Test Environment:
https://api.tst.eu.cloudretail.tech
Production Environment:
https://api.retailtech.yango.com
🛠️ For Developers
Project Architecture
Development Installation
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
Server works with 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 header
Methods: POST for most requests
Pagination: Cursor-based for large data
IDE Support
Claude Desktop: Uses
mcpServers
configurationCursor IDE: Uses
mcp.servers
configurationAuto-detection: Installer detects which IDEs are installed
Universal: Works without IDEs - configs always generated
📞 Support
If something doesn't work:
Check Python:
python3 --version
(should be 3.8+)Complete reset:
python3 cleanup.py && python3 install.py
Manual setup: Use generated config files (
claude_desktop_config.json
,cursor_settings.json
)Manual setup guide: MANUAL_SETUP.md for detailed instructions
Check IDE logs (Claude Desktop or Cursor IDE)
Make sure IDEs are restarted after installation
🎯 Goal: One command - and everything works in both
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A server that enables seamless integration with Yango Tech e-commerce platform through Claude Desktop and Cursor IDE, allowing users to query orders, products, inventory and other business data using natural language.
Related MCP Servers
- AsecurityFlicenseAqualityThe server facilitates natural language interactions for exploring and understanding codebases, providing insights into data models and system architecture using a cost-effective, simple setup with support for existing Claude Pro subscriptions.Last updated -419
- -securityFlicense-qualityA server that enables interaction with PostgreSQL, MySQL, MariaDB, or SQLite databases through Claude Desktop using natural language queries.Last updated -
- -securityFlicense-qualityAn integration server that allows Claude Desktop to communicate with Make (formerly Integromat) automation platform through the Model Context Protocol, enabling scenario management and execution via natural language.Last updated -
- AsecurityAlicenseAqualityA server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.Last updated -3200MIT License