🚀 Yango Tech MCP服务器-一个命令安装
🛒 Yango技术集成
该项目提供了与 扬高科技 -领先的电子商务自动化平台。
Yango Tech是Yango Group的一部分，一家改变世界各地人们日常业务的全球科技公司：
📊 150米+ 自2018年以来的骑行\ 💰 25亿美元+ 商品交易总额\ ✅ 99.99% 订单已交付，无遗漏物品\ 📦 1.3米+ 每日订单
扬高科技 为以下方面提供全面的解决方案：
- 🌐 APP网站应用
- 🏪 订单管理 以及物流
- 📦 实时库存管理
- 🛍️ 产品编目 详细信息
- 🚚 交货和订单履行
- 📊 分析和销售报告
- 🔄 API集成 B2B自动化
通过此MCP服务器，您可以直接从 克劳德桌面 或 光标IDE，获取订单、产品、库存水平和其他平台信息。
用户-安装简单
下载此项目并运行一个命令：
python3 install.py完成！一切都将自动配置。 🎉
______________________________________________________________________
安装程序的作用：
- ✅ 自动检测您的操作系统 （Mac/Windows/Linux）
- ✅ 查找Python 并创建虚拟环境
- ✅ 安装所有依赖项 自动（包括FastMCP 2.5+）
- ✅ 检测已安装的IDE (克劳德桌面 & 光标IDE)
- ✅ 提供测试API密钥 或者你自己的
- ✅ 创建IDE配置 自动（如果安装了IDE）
- ✅ 生成配置文件 在项目根目录中手动设置
- ✅ 测试功能 使用真正的API
- ✅ 显示说明 接下来的步骤
💡 即使没有安装IDE也能工作 -配置文件总是生成的！
______________________________________________________________________
🎯 强大的IDE集成
🤖 克劳德桌面 & 光标IDE 准备好了！
安装后，您将拥有 无缝集成 与：
🖥️ 克劳德桌面
拥有Yango Tech实力的专业人工智能助手
- 💬 自然语言查询 至Yango Tech API
- 🔍 智能产品搜索 具有可读的名称
- 📋 订单管理 通过对话
- 📊 实时库存 检查
📸 看 克劳德桌面 在行动中：
🛍️ 产品目录分析： Claude Product Report
🎬 实时产品搜索演示：
📦 库存管理： Claude Stock Report
📋 订单详细信息查询： Claude Order Detail
🔍 订单状态跟踪： Claude Order Status
⚡ 光标IDE
AI驱动的代码编辑器，可访问业务数据
- 🛠️ 查询时的代码 扬高科技 数据
- 🔄 API集成 直接在您的工作流程中
- 📝 文档生成 有真实数据
- 🚀 快速原型制作 实时商业洞察
🎨 为什么这会改变游戏规则：
而不是在多个工具之间切换，您可以：
- ✨ 问克劳德: *“显示订单240920-728268的详细信息”*
- ✨ 问 光标: *“L001商店的哪些产品库存不足？”*
- ✨ 获得即时答案 随着 人类可读的产品名称
- ✨ 工作速度更快 随着 自然语言 而不是复杂的API调用
🔗 全部由 扬高科技 -您的电子商务自动化平台！
______________________________________________________________________
安装后
- get_order_details -获取包含产品名称的订单详细信息 - get_order_status -获取订单状态 - get_all_products -获取所有显示名称的产品 - get_products_batch -获取带有分页和名称的产品 - get_all_stocks -获取所有带有产品名称的库存 - get_stocks_batch -获取带有页码和名称的股票
🎯 主要特点： 所有工具都显示用户友好的产品名称，而不是神秘的产品ID！
______________________________________________________________________
📁 生成的配置文件
安装程序始终在项目根目录中创建这些文件：
将这些文件用于：
- 手动IDE设置
- 备份配置
- 将设置复制到其他计算机
- 故障排除
______________________________________________________________________
🧪 测试命令 克劳德桌面 & 光标IDE:
- “显示Yango Tech目录中的5个产品” （附产品名称）
- “显示商店中的产品库存” （附产品名称）
- “显示订单240920-728268的详细信息” （包含丰富的购物车商品）
- “获取240920-728268的订单状态”
______________________________________________________________________
⚙️ 需求
🐍 没有安装Python？
没问题！ 如果Python缺失或太旧，安装程序会显示详细的安装指南：
- macOS：官方安装程序、Homebrew或pyenv
- 视窗：官方安装程序(⚠️ 选中“添加到PATH”）、Microsoft Store或Chocolatey
- Linux：包管理器(
apt,dnf,pacman)或来源
为什么选择Python 3.8+？ FastMCP框架兼容性所需。
快速检查：运行 python3 --version 或 python --version
📖 详细指南：参见 巨蟒_设定.md 获取分步说明
______________________________________________________________________
🧹 完成环境重置
如果需要彻底清洁并重新安装：
python3 cleanup.py
python3 install.py清理脚本将删除：
- 虚拟环境
- 来自两个IDE的配置文件
- 生成的配置文件
- 环境文件
- 缓存文件
______________________________________________________________________
🌍 API终点
- 测试环境:
https://api.tst.eu.cloudretail.tech - 生产环境:
https://api.retailtech.yango.com
______________________________________________________________________
🛠️ 对于开发者
Technical Information
项目架构
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开发安装
# 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技术栈
- FastMCP 2.5+：现代MCP服务器框架
- Python 3.8+：核心语言
- HTTPx：异步HTTP客户端
- 派丹蒂克：数据验证
- 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支持
______________________________________________________________________
📞 支持
如果有什么不起作用：
- 检查Python:
python3 --version（应为3.8+） - 完全重置:
python3 cleanup.py && python3 install.py - 手动设置：使用生成的配置文件(
claude_desktop_config.json,cursor_settings.json) - 手动设置指南: 手动设置.md 详细说明
- 检查IDE日志 (克劳德桌面 或 光标IDE)
- 确保 IDE在安装后重新启动
______________________________________________________________________