金大哥 - mcp-server-public MCP 详情

article

README

🚀 🌐 通用MCP服务器

借助人工智能实现电子商务集成，为智能购物助手提供支持

通过模型上下文协议，将您的人工智能应用程序连接到3个以上的电子商务平台（Shopify、WooCommerce、Shopware 6），实现自动产品搜索、价格协商和智能折扣生成。

✨ 主要特性

🔍 产品搜索 - 跨所有连接平台进行自然语言查询
💰 价格协商 - 智能定价，自动生成折扣
🔗 智能链接 - 直接产品链接，自动应用折扣
🤖 多LLM支持 - 支持6家人工智能供应商（OpenAI、Anthropic、Google、Mistral、Cohere、Groq）
🧵 线程管理 - 持久对话，24小时过期
🌍 多货币支持 - 支持12种货币（欧元、美元、英镑、瑞士法郎等）
⚡ 生产就绪 - 企业级性能和安全性
🆓 免费使用 - 无费用、无佣金，向所有人开放

🚀 快速开始

选项1：直接HTTP API（推荐）

# 在https://unifiedoffer.com获取免费API密钥
curl -X POST https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "searchProducts",
    "arguments": {
      "query": "价格低于1500美元的游戏笔记本电脑",
      "limit": 5
    }
  }'

选项2：NPM包

npm install @unifiedoffer/mcp-server

选项3：PyPI包

pip install uop-mcp-server

选项4：Docker

docker pull unifiedoffer/mcp-server:latest
docker run -p 8080:8080 -e UOP_API_KEY=your_key unifiedoffer/mcp-server

🛠️ 可用工具

| 工具 | 描述 | 延迟 | 复杂度 | |------|-------------|---------|------------| | searchProducts | 跨所有平台搜索产品 | 约1.7秒 | 中等 | | generateLinks | 创建带有折扣的直接产品链接 | 约2.1秒 | 中等 | | negotiatePrice | 智能价格协商 | 约2.3秒 | 高 | | negotiateBatch | 竞争性批量定价 | 约2.8秒 | 高 | | negotiateMultiRound | 渐进式多轮协商 | 约3.2秒 | 高 | | chat | 人工智能购物助手（6家LLM供应商） | 约5.7秒 | 高 | | listThreads | 列出对话线程 | 约0.6秒 | 低 | | getThread | 检索线程历史记录 | 约0.8秒 | 低 | | extendThread | 延长线程过期时间 | 约0.8秒 | 低 |

平均响应时间：2.2秒 | 成功率：100%

📚 详细文档

入门指南

认证指南 - API密钥设置
快速入门指南 - 第一步
代码示例 - 集成示例

API参考

工具规范 - 完整的MCP清单
OpenAPI规范 - REST API文档

高级主题

多LLM配置 - 供应商设置
线程管理 - 对话持久性
速率限制 - 使用配额

🌍 支持的平台

| 平台 | 产品同步 | 折扣代码 | Webhook | 状态 | |----------|-------------|----------------|----------|--------| | Shopify | ✅ | ✅ | ✅ | 生产环境 | | WooCommerce | ✅ | ✅ | ✅ | 生产环境 | | Shopware 6 | ✅ | ✅ | ✅ | 生产环境 | | Magento | ⏳ | ⏳ | ⏳ | 计划中 |

💻 使用示例

AI购物助手

// 自然语言产品搜索
const response = await fetch('https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    'tool': 'chat',
    'arguments': {
      'message': '我需要一台价格低于2000美元的视频编辑笔记本电脑',
      'configName': 'openai-gpt-4o'
    }
  })
});

价格比较工具

# 竞争性比较多个产品
import requests

response = requests.post(
    'https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper',
    headers={'x-api-key': 'YOUR_API_KEY'},
    json={
        'tool': 'negotiateBatch',
        'arguments': {
            'productIds': ['prod_123', 'prod_456', 'prod_789']
        }
    }
)

电子商务集成

# 生成带有自动折扣的产品链接
curl -X POST https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "generateLinks",
    "arguments": {
      "productIds": ["prod_abc", "prod_def"]
    }
  }'

🔐 认证

在 https://unifiedoffer.com 获取免费API密钥。

有两种类型的密钥可供使用：

开发者密钥 (dk_*) - 搜索所有店铺，优化客户价值
商家密钥 (mk_*) - 店铺范围搜索，优化商家利润

使用方法：

# 标准头部（推荐）
-H "x-api-key: dk_YOUR_API_KEY"

# 替代授权头部
-H "X-Authorization: Bearer dk_YOUR_API_KEY"

# 查询参数（备用）
?api_key=dk_YOUR_API_KEY

⚡ 速率限制

| 工具类别 | 限制 | 工具 | |---------------|-------|-------| | 轻量级 | 100次请求/分钟 | listThreads、getThread、extendThread | | 标准 | 60次请求/分钟 | searchProducts、generateLinks | | 重量级 | 30次请求/分钟 | negotiatePrice、chat | | 批量 | 20次请求/分钟 | negotiateBatch、negotiateMultiRound |

🌐 多货币支持

自动处理12种货币：

欧元 (€) • 美元 ($) • 英镑 (£) • 瑞士法郎 (CHF) • 加元 (C$) • 澳元 (A$) • 日元 (¥) • 瑞典克朗 (kr) • 挪威克朗 (kr) • 丹麦克朗 (kr) • 波兰兹罗提 (zł) • 捷克克朗 (Kč)

每种货币的最低折扣会自动调整（例如，1欧元、1美元、0.85英镑）。

🤖 AI供应商支持

可与6家LLM供应商（40多种模型）无缝协作：

| 供应商 | 模型 | 特性 | |----------|--------|----------| | OpenAI | GPT - 5、GPT - 4.1、GPT - 4o系列（8种模型） | 最佳函数调用，JSON模式 | | Anthropic | Claude Sonnet 4.5、Opus 4.1、Claude 3.5（5种模型） | 最佳编码，100万上下文 | | Google | Gemini 2.5 Pro、2.5 Flash、2.0 Flash（5种模型） | 最佳性价比 | | Mistral | Medium 3、Devstral Small、Large/Small（6种模型） | 多语言支持 | | Cohere | Command A、Aya Expanse（5种模型） | 支持23种语言 | | Groq | OpenAI GPT - OSS、Llama 4 Vision（12种模型） | 超快速推理 |

BYOK模型：自带密钥 - 使用您自己的LLM API密钥，零成本。

🏗️ 架构

┌─────────────────┐
│   AI应用/代理  │
└────────┬────────┘
         │ MCP协议（HTTP/WebSocket）
         ▼
┌─────────────────┐
│  MCP服务器     │
│  （边缘函数）  │
└────────┬────────┘
         │ REST API
         ▼
┌─────────────────────────────────┐
│  产品数据库（PostgreSQL）      │
│  - Shopify产品                 │
│  - WooCommerce产品             │
│  - Shopware产品                │
└─────────────────────────────────┘

📊 性能

正常运行时间：99.9%
平均延迟：2.2秒
成功率：100%
并发请求：1000+
数据库：企业级PostgreSQL，145+优化索引

🔒 安全

✅ API密钥在存储前进行哈希处理
✅ 170条活跃的行级安全策略
✅ 速率限制，具备故障安全默认设置
✅ CORS正确配置
✅ 响应中无敏感信息
✅ A+级安全审计

📦 分发渠道

| 渠道 | 包 | 状态 | |---------|---------|--------| | NPM | @unifiedoffer/mcp-server | ✅ v2.0.4 | | PyPI | uop-mcp-server | ✅ v2.0.5 | | Docker Hub | unifiedoffer/mcp-server | ✅ v2.0.0 | | GitHub MCP注册表 | io.github.Chris85appding/unified-offer-protocol | ✅ v2.0.5 | | PulseMCP | 自动索引 | ⏳ 待处理 | | MCP.so | 手动提交 | ⏳ 待处理 |

🤝 支持与社区

网站：https://unifiedoffer.com
文档：https://unifiedoffer.com/mcp
API端点：https://api.unifiedoffer.com/functions/v1/mcp-http-wrapper
邮箱：support@unifiedoffer.com
问题反馈：https://github.com/UnifiedOffer/mcp-server-public/issues

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE。

🎯 路线图

2.1版本（2026年第一季度）

[ ] 集成Magento平台
[ ] 实时库存同步
[ ] 增强批量协商策略
[ ] WebSocket传输层

2.2版本（2026年第二季度）

[ ] 多区域部署
[ ] GraphQL API端点
[ ] 增强分析仪表盘
[ ] 自定义LLM微调

🌟 为什么选择UOP MCP服务器？

✅ 生产就绪 - 企业级性能和安全性
✅ 零设置 - 直接HTTP API，无需复杂配置
✅ 多平台支持 - 支持Shopify、WooCommerce、Shopware 6
✅ 性价比高 - BYOK模型，按需付费
✅ 功能齐全 - 9种工具，涵盖搜索、协商、链接、聊天等功能
✅ 文档完善 - 全面的指南和示例
✅ 开源 - MIT许可证，社区驱动
✅ 完全免费 - 无费用、无佣金、无隐藏成本

由Unified Offer Protocol团队用心打造
免费开始使用 • 查看文档 • 报告问题

mcp-server-public