JinDaGe - yangotech_mcp MCP Details

article

README

🚀 扬果科技MCP服务器 - 一键安装

本项目提供了与**扬果科技**的集成，扬果科技是电商自动化领域的领先平台。

扬果科技是扬果集团的一部分，扬果集团是一家全球性科技公司，致力于改变全球人们的日常业务：

📊 自2018年以来，出行订单超1.5亿
💰 商品交易总额超25亿美元
✅ 订单商品无缺失交付率达99.99%
📦 日订单量超130万

扬果科技提供以下全面解决方案：

🌐 APP与网站应用
🏪 订单管理与物流
📦 实时库存管理
🛍️ 产品目录，包含详细信息
🚚 配送与订单履行
📊 分析与销售报告
🔄 B2B自动化的API集成

通过这个MCP服务器，你可以直接从Claude桌面版或Cursor IDE轻松与扬果科技API进行交互，获取订单、产品、库存水平等平台信息。

🚀 快速开始

✨ 主要特性

与扬果科技集成，提供全面电商自动化解决方案。
支持一键安装，自动完成各项配置。
强大的IDE集成，支持Claude桌面版和Cursor IDE。
安装程序自动检测操作系统、Python环境，创建虚拟环境并安装依赖。
提供测试API密钥或使用自定义密钥。
自动生成IDE配置文件，支持手动设置。
可使用真实API测试功能。

📦 安装指南

普通用户 - 简单安装

下载本项目并运行一条命令：

python3 install.py

完成！一切将自动配置完成。 🎉

安装程序的功能：

✅ 自动检测你的操作系统（Mac/Windows/Linux）
✅ 查找Python 并创建虚拟环境
✅ 自动安装所有依赖项（包括FastMCP 2.5+）
✅ 检测已安装的IDE（Claude桌面版和 Cursor IDE）
✅ 提供测试API密钥 或使用你自己的密钥
✅ 自动创建IDE配置（如果已安装IDE）
✅ 在项目根目录生成配置文件 用于手动设置
✅ 使用真实API测试功能
✅ 显示下一步操作说明

💡 即使未安装IDE也能正常工作 - 始终会生成配置文件！

💻 使用示例

基础用法

下载项目并运行安装命令：

python3 install.py

高级用法

如果你需要完全清理并重新安装：

python3 cleanup.py
python3 install.py

📚 详细文档

安装后操作

重启 Claude桌面版和/或 Cursor IDE（如果已安装）
你将拥有6个扬果科技工具，支持产品名称丰富显示：
- get_order_details - 获取包含产品名称的订单详情
- get_order_status - 获取订单状态
- get_all_products - 获取包含显示名称的所有产品
- get_products_batch - 分页获取包含名称的产品
- get_all_stocks - 获取包含产品名称的所有库存
- get_stocks_batch - 分页获取包含名称的库存

🎯 关键特性： 所有工具均显示用户友好的产品名称，而非晦涩的产品ID！

生成的配置文件

安装程序会在项目根目录始终创建以下文件：

claude_desktop_config.json - 可直接使用的 Claude桌面版配置文件
cursor_settings.json - 可直接使用的 Cursor IDE 配置文件

这些文件可用于：

手动设置IDE
备份配置
将设置复制到其他机器
故障排除

测试命令

适用于 Claude桌面版和 Cursor IDE 的测试命令：

"显示扬果科技目录中的5个产品"（包含产品名称）
"显示商店中的产品库存"（包含产品名称）
"显示订单240920 - 728268的详情"（包含丰富的购物车商品信息）
"获取订单240920 - 728268的状态"

🔧 技术细节

项目架构

yangotech_mcp/
├── install.py               # 🎯 通用安装程序  
├── cleanup.py               # 🧹 完全清理脚本
├── server.py                # FastMCP服务器
├── client.py                # 扬果科技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端点

服务器与真实的扬果科技API配合使用：

测试URL：https://api.tst.eu.cloudretail.tech/b2b/v1
生产URL：https://api.retailtech.yango.com/b2b/v1
授权：在请求头中使用OAuth令牌
方法：大多数请求使用POST方法
分页：大数据集使用基于游标分页

IDE支持

Claude桌面版：使用 mcpServers 配置
Cursor IDE：使用 mcp.servers 配置
自动检测：安装程序会检测已安装的IDE
通用性：即使未安装IDE也能工作 - 始终会生成配置文件

📄 许可证

原文档未提及许可证信息，故此处跳过。

⚙️ 要求

Python 3.8+（自动检测并验证）
互联网连接 用于下载依赖项
Claude桌面版 和/或 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 获取分步说明

🧹 完全环境重置