STARWARCLOUD STARWAR.AI
返回市场
阳奥科技_mcp

阳奥科技_mcp

作者：zamb12411 星标更新：2025-05-25
安装使用来源：spider==github.com

项目介绍

🚀 Yango Tech MCP Server - 单命令安装

🛒 Yango Tech 集成

本项目提供了与 Yango Tech 的集成，这是一个领先的电子商务自动化平台。

Yango Tech 是 Yango 集团的一部分，该集团是一家全球科技公司，致力于改变世界各地人们的日常生活：

📊 自2018年以来超过1.5亿次出行
💰 超过25亿美元的GMV
✅ **99.99%**订单无缺件送达
📦 每天处理超过130万订单

Yango Tech 提供全面的解决方案：

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

通过这个MCP服务器，您可以轻松地从 Claude Desktop 或 Cursor IDE 直接与 Yango Tech API 进行交互，获取订单、产品、库存水平和其他平台信息。

用户指南 - 简单安装

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

python3 install.py

完成！所有配置将自动进行。 🎉

安装程序做了什么：

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

💡 即使没有安装IDE，配置文件也会始终生成！

🎯 强大的IDE集成

🤖 Claude Desktop & Cursor IDE 就绪！

安装后，您将拥有与以下内容的无缝集成：

🖥️ Claude Desktop

具有Yango Tech能力的专业AI助手

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

📸 查看 Claude Desktop 在行动：

🛍️ 产品目录分析： Claude 产品报告

🎬 实时产品搜索演示：

Claude 产品演示

📦 库存管理： Claude 库存报告

📋 订单详情查询： Claude 订单详情

🔍 订单状态跟踪： Claude 订单状态

⚡ Cursor IDE

具有业务数据访问能力的AI驱动代码编辑器

  • 🛠️ 在查询Yango Tech数据的同时编写代码
  • 🔄 直接在工作流程中集成API
  • 📝 使用真实数据生成文档
  • 🚀 利用实时商业洞察快速原型设计

🎨 为什么这是革命性的：

无需在多个工具之间切换，您可以：

  • ✨ 询问Claude："显示订单240920-728268的详细信息"
  • ✨ 询问 Cursor："L001店哪些产品库存低？"
  • ✨ 立即获得答案，带有可读的产品名称
  • ✨ 使用 自然语言 更快地工作，而不是复杂的API调用

🔗 所有功能由 Yango Tech 提供支持 - 您的电子商务自动化平台！

安装后

  1. 重启 Claude Desktop 和/或 Cursor IDE（如果已安装）
  2. 您将拥有6个增强产品名称的Yango Tech工具：
    • get_order_details - 获取订单详情，附带产品名称
    • get_order_status - 获取订单状态
    • get_all_products - 获取所有产品，附带展示名称
    • get_products_batch - 分页获取产品及名称
    • get_all_stocks - 获取所有库存，附带产品名称
    • get_stocks_batch - 分页获取库存及名称

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

📁 生成的配置文件

安装程序始终在项目根目录创建这些文件：

  • claude_desktop_config.json - 可直接使用的 Claude Desktop 配置
  • cursor_settings.json - 可直接使用的 Cursor IDE 配置

使用这些文件：

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

🧪 Claude Desktop & Cursor IDE 测试命令：

  • "显示Yango Tech目录中的5个产品"（附带产品名称）
  • "显示商店中的产品库存"（附带产品名称）
  • "显示订单240920-728268的详细信息"（附带丰富购物车项）
  • "获取订单240920-728268的状态"

⚙️ 要求

  • Python 3.8+（自动检测和验证）
  • 互联网用于下载依赖项
  • Claude Desktop 和/或 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 了解逐步说明

🧹 完全环境重置

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

python3 cleanup.py
python3 install.py

清理脚本删除：

  • 虚拟环境
  • 来自两个IDE的配置文件
  • 生成的配置文件
  • 环境文件
  • 缓存文件

🌍 API端点

  • 测试环境：https://api.tst.eu.cloudretail.tech
  • 生产环境：https://api.retailtech.yango.com

🛠️ 开发者指南

<details> <summary>技术信息</summary>

项目架构

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

技术栈

API端点

服务器与真实的Yango Tech API协作：

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

IDE支持

  • Claude Desktop：使用mcpServers配置
  • Cursor IDE：使用mcp.servers配置
  • 自动检测：安装程序检测已安装的IDE
  • 通用性：即使没有IDE也有效 - 配置文件始终生成
</details>

📞 支持

如果某些功能不起作用：

  1. 检查Python：python3 --version（应为3.8+）
  2. 完全重置：python3 cleanup.py && python3 install.py
  3. 手动设置：使用生成的配置文件（claude_desktop_config.json，cursor_settings.json）
  4. 手动设置指南：MANUAL_SETUP.md 详细说明
  5. 检查IDE日志（Claude Desktop 或 Cursor IDE）
  6. 确保 安装后重启了IDE

🎯 目标：一个命令 - 在 Claude Desktop 和 Cursor IDE 中一切正常工作（或生成手动设置的配置文件）！