电商自动化集成服务

Yango Tech MCP Server提供一站式电商自动化集成解决方案,支持订单管理、库存跟踪、产品目录查询等功能,并与Claude Desktop和Cursor IDE无缝集成。

  • by zamb124
  • Python
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 zamb124/yangotech_mcp

使用说明

🚀 Yango Tech MCP服务器-一个命令安装

🛒 Yango技术集成

该项目提供了与 扬高科技 -领先的电子商务自动化平台。

Yango Tech是Yango Group的一部分,一家改变世界各地人们日常业务的全球科技公司:

📊 150米+ 自2018年以来的骑行
💰 25亿美元+ 商品交易总额
✅ 99.99% 订单已交付,无遗漏物品
📦 1.3米+ 每日订单

扬高科技 为以下方面提供全面的解决方案:

  • 🌐 APP网站应用
  • 🏪 订单管理 以及物流
  • 📦 实时库存管理
  • 🛍️ 产品编目 详细信息
  • 🚚 交货和订单履行
  • 📊 分析和销售报告
  • 🔄 API集成 B2B自动化

通过此MCP服务器,您可以直接从 克劳德桌面 或 光标IDE,获取订单、产品、库存水平和其他平台信息。

用户-安装简单

下载此项目并运行一个命令:

python3 install.py

完成!一切都将自动配置。 🎉


安装程序的作用:

  1. ✅ 自动检测您的操作系统 (Mac/Windows/Linux)
  2. ✅ 查找Python 并创建虚拟环境
  3. ✅ 安装所有依赖项 自动(包括FastMCP 2.5+)
  4. ✅ 检测已安装的IDE (克劳德桌面 & 光标IDE)
  5. ✅ 提供测试API密钥 或者你自己的
  6. ✅ 创建IDE配置 自动(如果安装了IDE)
  7. ✅ 生成配置文件 在项目根目录中手动设置
  8. ✅ 测试功能 使用真正的API
  9. ✅ 显示说明 接下来的步骤

💡 即使没有安装IDE也能工作 -配置文件总是生成的!


🎯 强大的IDE集成

🤖 克劳德桌面 & 光标IDE 准备好了!

安装后,您将拥有 无缝集成 与:

🖥️ 克劳德桌面

拥有Yango Tech实力的专业人工智能助手

  • 💬 自然语言查询 至Yango Tech API
  • 🔍 智能产品搜索 具有可读的名称
  • 📋 订单管理 通过对话
  • 📊 实时库存 检查

📸 看 克劳德桌面 在行动中:

🛍️ 产品目录分析:

🎬 实时产品搜索演示:

📦 库存管理:

📋 订单详细信息查询:

🔍 订单状态跟踪:

⚡ 光标IDE

AI驱动的代码编辑器,可访问业务数据

  • 🛠️ 查询时的代码 扬高科技 数据
  • 🔄 API集成 直接在您的工作流程中
  • 📝 文档生成 有真实数据
  • 🚀 快速原型制作 实时商业洞察

🎨 为什么这会改变游戏规则:

而不是在多个工具之间切换,您可以:

  • ✨ 问克劳德: “显示订单240920-728268的详细信息”
  • ✨ 问 光标: “L001商店的哪些产品库存不足?”
  • ✨ 获得即时答案 随着 人类可读的产品名称
  • ✨ 工作速度更快 随着 自然语言 而不是复杂的API调用

🔗 全部由 扬高科技 -您的电子商务自动化平台!


安装后

  1. 重启 克劳德桌面 和 光标IDE (如果已安装)
  2. 您将拥有6个产品名称丰富的Yango Tech工具:
    • 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 3.8+ (自动检测和验证)
  • 互联网 用于下载依赖项
  • 克劳德桌面 和 光标IDE (可选-无论如何都会生成配置)

🐍 没有安装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

技术栈

API终点

服务器使用真正的Yango Tech API:

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

IDE支持

  • 克劳德桌面:用途 mcpServers 配置
  • 光标IDE:用途 mcp.servers 配置
  • 自动检测:安装程序检测安装了哪些IDE
  • 通用:无需IDE即可工作-始终生成配置

📞 支持

如果有什么不起作用:

  1. 检查Python: python3 --version (应为3.8+)
  2. 完全重置: python3 cleanup.py && python3 install.py
  3. 手动设置:使用生成的配置文件(claude_desktop_config.json, cursor_settings.json)
  4. 手动设置指南: 手动设置.md 详细说明
  5. 检查IDE日志 (克劳德桌面 或 光标IDE)
  6. 确保 IDE在安装后重新启动

🎯 目标:一个命令-一切都在两者中工作 克劳德桌面 和 光标IDE (或生成手动设置的配置)!