Content
# 🚀 Yango Tech MCP Server - One Command Installation
## 🛒 Yango Tech Integration
This project provides integration with **[Yango Tech](https://yango-tech.com/)** - 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](https://www.anthropic.com/claude) or [Cursor IDE](https://www.cursor.com/), gaining access to orders, products, stock levels, and other platform information.
## For Users - Simple Installation
**Download this project and run one command:**
```bash
python3 install.py
```
**Done! Everything will be configured automatically.** 🎉
---
## What the installer does:
1. ✅ **Automatically detects your OS** (Mac/Windows/Linux)
2. ✅ **Finds Python** and creates virtual environment
3. ✅ **Installs all dependencies** automatically (including FastMCP 2.5+)
4. ✅ **Detects installed IDEs** ([Claude Desktop](https://www.anthropic.com/claude) & [Cursor IDE](https://www.cursor.com/))
5. ✅ **Offers test API key** or your own
6. ✅ **Creates IDE configurations** automatically (if IDEs installed)
7. ✅ **Generates config files** in project root for manual setup
8. ✅ **Tests functionality** with real API
9. ✅ **Shows instructions** for next steps
**💡 Works even without IDEs installed** - configuration files are always generated!
---
# 🎯 **POWERFUL IDE INTEGRATION**
## 🤖 **[Claude Desktop](https://www.anthropic.com/claude) & [Cursor IDE](https://www.cursor.com/) Ready!**
After installation, you'll have **seamless integration** with:
### 🖥️ **[Claude Desktop](https://www.anthropic.com/claude)**
**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 [Claude Desktop](https://www.anthropic.com/claude) in Action:**
**🛍️ Product Catalog Analysis:**
**🎬 Live Product Search Demo:**
**📦 Inventory Management:**
**📋 Order Details Lookup:**
**🔍 Order Status Tracking:**
### ⚡ **[Cursor IDE](https://www.cursor.com/)**
**AI-powered code editor with business data access**
- 🛠️ **Code while querying** [Yango Tech](https://yango-tech.com/) 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 [Cursor](https://www.cursor.com/)**: *"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 [Yango Tech](https://yango-tech.com/) - your ecommerce automation platform!**
---
## After installation
1. **Restart [Claude Desktop](https://www.anthropic.com/claude) and/or [Cursor IDE](https://www.cursor.com/)** (if installed)
2. **You'll have 6 Yango Tech tools with product name enrichment:**
- `get_order_details` - Get order details with product names
- `get_order_status` - Get order status
- `get_all_products` - Get all products with display names
- `get_products_batch` - Get products with pagination and names
- `get_all_stocks` - Get all stocks with product names
- `get_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](https://www.anthropic.com/claude) configuration
- **`cursor_settings.json`** - Ready-to-use [Cursor IDE](https://www.cursor.com/) configuration
**Use these files for:**
- Manual IDE setup
- Backup configurations
- Copying settings to other machines
- Troubleshooting
---
## 🧪 Test commands for [Claude Desktop](https://www.anthropic.com/claude) & [Cursor IDE](https://www.cursor.com/):
- **"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](https://www.anthropic.com/claude)** and/or **[Cursor IDE](https://www.cursor.com/)** (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](PYTHON_SETUP.md) for step-by-step instructions
---
## 🧹 Complete Environment Reset
If you need to completely clean and reinstall:
```bash
python3 cleanup.py
python3 install.py
```
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
<details>
<summary>Technical Information</summary>
### 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
```bash
# 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+](https://github.com/jlowin/fastmcp)**: Modern MCP server framework
- **[Python 3.8+](https://www.python.org/)**: Core language
- **[HTTPx](https://www.python-httpx.org/)**: Async HTTP client
- **[Pydantic](https://docs.pydantic.dev/latest/)**: Data validation
- **[python-dotenv](https://github.com/theskumar/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](https://www.anthropic.com/claude)**: Uses `mcpServers` configuration
- **[Cursor IDE](https://www.cursor.com/)**: Uses `mcp.servers` configuration
- **Auto-detection**: Installer detects which IDEs are installed
- **Universal**: Works without IDEs - configs always generated
</details>
---
## 📞 Support
If something doesn't work:
1. **Check Python**: `python3 --version` (should be 3.8+)
2. **Complete reset**: `python3 cleanup.py && python3 install.py`
3. **Manual setup**: Use generated config files (`claude_desktop_config.json`, `cursor_settings.json`)
4. **Manual setup guide**: [MANUAL_SETUP.md](MANUAL_SETUP.md) for detailed instructions
5. **Check IDE logs** ([Claude Desktop](https://www.anthropic.com/claude) or [Cursor IDE](https://www.cursor.com/))
6. **Make sure** IDEs are restarted after installation
---
**🎯 Goal: One command - and everything works in both [Claude Desktop](https://www.anthropic.com/claude) and [Cursor IDE](https://www.cursor.com/) (or generates configs for manual setup)!**
