多市场MCP服务器

Name: 多市场MCP服务器
Author: caiovicentino

作者：caiovicentino6 星标更新：2025-11-11

安装使用来源：spider==github.com

项目介绍

技术文档摘要

🤖 Polymarket MCP 服务器

完整的AI驱动交易平台用于Polymarket预测市场

启用Claude自主进行交易、分析和管理在Polymarket上的仓位，提供45种全面工具、实时WebSocket监控以及企业级安全特性。

👨‍💻 开发者

Caio Vicentino

与以下团队合作开发：

🌾 Yield Hacker - DeFi创新社区
💰 Renda Cripto - 加密货币交易社区
🏗️ Cultura Builder - 构建文化社区

由 Claude Code 提供支持

⭐ 关键特性

🎯 跨越五个类别的45种全面工具

🔍 市场发现 (8个工具)

按关键词、类别、事件搜索和筛选市场
按成交量的趋势市场 (24小时、7天、30天)
特定类别的市场 (政治、体育、加密货币)
即将结束的市场提醒
特选和推广市场
体育市场 (NBA、NFL等)
加密货币预测市场

📊 市场分析 (10个工具)

实时价格和价差
完整订单簿深度分析
流动性和成交量指标
历史价格数据
AI驱动的机会分析，带有买入/卖出/持有建议
多市场比较
最大持有者分析
风险评估和评分
价差计算和监控

💼 交易 (12个工具)

限价单 (GTC, GTD, FOK, FAK)
市价单 (立即执行)
批量下单
AI建议定价 (激进/被动/中间策略)
订单状态跟踪和历史
开仓订单管理
单个和批量取消订单
智能交易执行 (自然语言→自动化策略)
仓位再平衡，带有滑点保护
订单簿集成

📈 投资组合管理 (8个工具)

实时仓位跟踪
盈亏计算 (已实现/未实现)
投资组合价值汇总
风险分析 (集中度、流动性、多元化)
过滤器下的交易历史
链上活动日志
绩效指标
AI驱动的投资组合优化 (保守/平衡/激进)

⚡ 实时监控 (7个工具)

通过WebSocket实时价格更新
订单簿深度流
用户订单状态通知
交易执行提醒
市场解决通知
订阅管理
系统健康监控
自动重连带指数退避

🛡️ 企业级安全及风险管理

✅ 订单大小限制 - 可配置的最大每笔订单
✅ 暴露上限 - 总投资组合暴露限制
✅ 仓位限制 - 每个市场的仓位上限
✅ 流动性验证 - 最小流动性要求
✅ 价差容忍度 - 执行前的最大价差检查
✅ 确认流程 - 大额订单用户确认
✅ 预交易验证 - 全面的安全检查

⚙️ 生产就绪基础设施

✅ L1 & L2 认证 - 钱包 (私钥) + API 密钥认证
✅ 高级速率限制 - 尊重所有Polymarket API限制的令牌桶算法
✅ EIP-712 签名 - 安全订单签名
✅ 自动重连WebSockets - 强大的实时连接
✅ 全面错误处理 - 用户友好的错误消息
✅ 无模拟 - 整个过程中的真实Polymarket API集成
✅ 完整测试覆盖 - 使用真实API的生产级测试

🌐 网页仪表板

新功能：使用现代网页界面管理和监控您的Polymarket MCP服务器！

# 启动网页仪表板
polymarket-web

# 或使用快速启动脚本
./start_web_dashboard.sh

访问地址：http://localhost:8080

仪表板功能

实时监控：实时MCP状态、WebSocket连接和统计数据
配置管理：视觉滑块用于安全限制和交易控制
市场发现：搜索、筛选和浏览市场，实时更新
市场分析：AI驱动的分析，带有建议和风险评估
系统监控：性能图表、速率限制和活动日志
暗主题：专业UI，适合长时间使用

参见 WEB_DASHBOARD.md 获取完整文档。

🚀 快速开始

一键安装（推荐）

首先尝试DEMO模式（无需钱包）：

# macOS/Linux
curl -sSL https://raw.githubusercontent.com/caiovicentino/polymarket-mcp-server/main/quickstart.sh | bash

# 或克隆并本地运行
git clone https://github.com/caiovicentino/polymarket-mcp-server.git
cd polymarket-mcp-server
./quickstart.sh

完整安装（带交易）：

# macOS/Linux
./install.sh

# Windows
install.bat

自动安装程序会：

✓ 检查Python版本（3.1
✓ 创建虚拟环境
✓ 安装所有依赖项
✓ 配置环境
✓ 设置Claude Desktop集成
✓ 测试安装

安装选项

方法	命令	最佳用途
快速开始	`./quickstart.sh`	初次用户，测试
DEMO模式	`./install.sh --demo`	无需钱包，只读访问
完整安装	`./install.sh`	生产交易设置
Windows	`install.bat`	Windows用户

DEMO模式 vs 完整模式

DEMO模式（无需钱包）：

✅ 市场发现和搜索
✅ 实时市场分析
✅ AI驱动的见解
✅ 价格监控
❌ 禁用交易（只读）

完整模式（需要Polygon钱包）：

✅ 包含DEMO模式的所有内容
✅ 下单和执行交易
✅ 投资组合管理
✅ 仓位跟踪
✅ 实时交易通知

手动安装

如果您更喜欢手动设置：

# 克隆仓库
git clone https://github.com/caiovicentino/polymarket-mcp-server.git
cd polymarket-mcp-server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows中：venv\Scripts\activate

# 安装包
pip install -e .

配置

选项1：DEMO模式（最简单）

cp .env.example .env
# 编辑.env并设置：
DEMO_MODE=true

选项2：完整交易模式

cp .env.example .env
# 使用您的Polygon钱包凭证编辑
nano .env

所需凭证（完整模式）：

POLYGON_PRIVATE_KEY=您的私钥（不带0x前缀）
POLYGON_ADDRESS=0x您的Polygon地址

推荐的安全限制：

MAX_ORDER_SIZE_USD=1000
MAX_TOTAL_EXPOSURE_USD=5000
MAX_POSITION_SIZE_PER_MARKET=2000
MIN_LIQUIDITY_REQUIRED=10000
MAX_SPREAD_TOLERANCE=0.05
ENABLE_AUTONOMOUS_TRADING=true
REQUIRE_CONFIRMATION_ABOVE_USD=500

Claude Desktop 集成

添加到您的Claude Desktop配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "polymarket": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["-m", "polymarket_mcp.server"],
      "cwd": "/path/to/polymarket-mcp-server",
      "env": {
        "POLYGON_PRIVATE_KEY": "您的私钥",
        "POLYGON_ADDRESS": "0x您的地址"
      }
    }
  }
}

重启Claude Desktop，您就可以开始交易了！🎉

📖 文档

入门指南

可视化安装指南 - 带有图表和截图的逐步指南
常见问题解答 - 常见问题和故障排除
设置指南 - 详细的配置说明
演示视频脚本 - 视频教程脚本

开发资源

工具参考 - 所有45种工具的完整API文档
代理集成指南 - 如何与您的代理集成
交易架构 - 系统设计和架构
WebSocket集成 - 实时数据设置

示例与指南

使用示例 - 所有工具的代码示例
测试示例 - 测试实现示例
市场分析脚本 - 高级分析示例

系统架构

┌─────────────────────────────────────────────────────────────┐
│                    POLYMARKET MCP SERVER                    │
└─────────────────────────────────────────────────────────────┘

    ┌──────────────┐
    │   Claude     │
    │   Desktop    │ (自然语言接口)
    └──────┬───────┘
           │ MCP协议
           ▼
    ┌──────────────────────────────────────────────┐
    │           MCP服务器（Python）                │
    ├──────────────────────────────────────────────┤
    │  ┌────────────┐  ┌──────────────────────┐   │
    │  │  市场      │  │  交易引擎            │   │
    │  │  发现      │  │  （12个工具）        │   │
    │  │  （8个工具）│  │                     │   │
    │  └────────────┘  └──────────────────────┘   │
    │                                              │
    │  ┌────────────┐  ┌──────────────────────┐   │
    │  │  市场      │  │  投资组合管理器      │   │
    │  │  分析      │  │  （8个工具）         │   │
    │  │  （10个工具）│  │                     │   │
    │  └────────────┘  └──────────────────────┘   │
    │                                              │
    │  ┌──────────────────────────────────────┐   │
    │  │  实时WebSocket（7个工具）           │   │
    │  └──────────────────────────────────────┘   │
    └──────────────┬───────────────────────────────┘
                   │
                   ▼
    ┌──────────────────────────────────────────────┐
    │         Polymarket基础设施                  │
    ├──────────────────────────────────────────────┤
    │  • CLOB API（订单放置与管理）             │
    │  • Gamma API（市场数据与分析）            │
    │  • WebSocket（实时价格推送）              │
    │  • Polygon链（结算与执行）                │
    └──────────────────────────────────────────────┘

💡 使用示例

市场发现

询问Claude：

"显示Polymarket上过去24小时内趋势排名前十的市场"
"查找所有关于比特币的加密货币市场"
"哪些体育市场将在接下来的12小时内关闭？"
"搜索关于特朗普的市场"

市场分析

"分析政府关门市场的交易机会"
"比较这三个市场，告诉我哪个具有最佳的风险回报比"
"Eagles vs Packers市场的当前价差是多少？"
"显示代币ID xyz的订单簿深度"

自主交易

"以$0.65的价格购买[市场ID]中的$100 YES代币"
"下单：在[市场]中以$0.40的价格卖出200 NO"
"执行智能交易：在[市场]中使用最佳策略购买YES至多$500"
"取消我在政府关门市场中的所有开放订单"
"将我在[市场]中的仓位重新平衡至$1000，最大滑点2%"

投资组合管理

"显示我当前的所有仓位"
"我的总投资组合价值是多少？"
"分析我的投资组合风险并提出改进建议"
"过去30天的盈亏是多少？"
"哪些是我表现最好和最差的市场？"
"为保守策略建议投资组合优化"

实时监控

"订阅政府关门市场的价格变化"
"实时监控我的订单状态"
"当Eagles vs Packers市场的变动超过10%时通知我"
"显示代币ID [token_id]的实时订单簿更新"

🧪 测试

# 安装开发依赖项
pip install -e ".[dev]"

# 运行所有测试
pytest

# 运行特定测试套件
pytest tests/test_trading_tools.py -v

# 带覆盖率运行
pytest --cov=polymarket_mcp --cov-report=html

# 运行市场分析演示
python demo_mcp_tools.py

注意：所有测试均使用真实的Polymarket API - 无模拟！

🛡️ 安全与保障

⚠️ 重要安全注意事项

私钥保护：切勿分享或提交您的私钥
从小金额开始：从少量金额（$50-100）开始测试
理解市场：仅在您了解的市场中交易
监控仓位：定期检查您的仓位
使用安全限制：根据您的风险承受能力配置适当限制
永不冒险：超出您能承受的损失

默认安全限制

MAX_ORDER_SIZE_USD=1000              # 每笔订单最大$1,000
MAX_TOTAL_EXPOSURE_USD=5000          # 总投资组合暴露最大$5,000
MAX_POSITION_SIZE_PER_MARKET=2000    # 每个市场的仓位上限$2,000
MIN_LIQUIDITY_REQUIRED=1_0000         # 最小市场流动性$10,000
MAX_SPREAD_TOLERANCE=0.05            # 最大5%价差
REQUIRE_CONFIRMATION_ABOVE_USD=500   # 确认超过$500的订单

这些可以在您的.env文件或Claude Desktop配置中自定义。

🤝 贡献

欢迎贡献！我们感谢您帮助改进这个项目。

请阅读 CONTRIBUTING.md 了解详情：

如何报告错误
如何建议功能
代码标准和指南
拉取请求流程

快速贡献指南

分叉仓库
创建您的功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m '添加一些AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
打开拉取请求

📊 项目统计

代码行数：~10,000+（Python）
工具：45种全面工具
测试覆盖率：高（真实API集成）
文档：全面（多个指南）
依赖项：现代Python包（MCP, httpx, websockets, eth-account）

🌐 社区

加入我们的社区

🌾 **[Yield Hacker