caiovicentino/polymarket-mcp-server

🤖 AI-Powered MCP Server for Polymarket - Enable Claude to trade prediction markets with 45 tools, real-time monitoring, and enterprise-grade safety features

🤖 Polymarket MCP Server – Polymarket 的 AI 增强交易系统

简介 – 这是一个基于 Python 的服务器，实现了 Model Context Protocol (MCP)，让 Anthropic 的 Claude 能够与 Polymarket 预测市场 API 互动。它公开了 45 种现成的“工具”（函数），让 Claude（或任何兼容 MCP 的代理程序）能够发现市场、分析订单簿、下单与管理交易，并实时监控投资组合。

重要性 – 预测市场交易是自主代理程序一个利基但正在成长的领域。通过将 Polymarket 的 CLOB、Gamma 与 WebSocket 端点封装在一个安全至上的 MCP 服务器后，该项目让大型语言模型代理程序在执行可配置风险限制的同时，扮演半自主交易者的角色。

核心功能（分为五大工具类别）

类别	工具	功能说明
市场发现 (8)	关键词搜索、热门列表、类别筛选、即将结束提醒、体育与加密货币市场浏览器	快速找到符合策略或兴趣的市场。
市场分析 (10)	实时价格/价差、订单簿深度、流动性与成交量指标、历史价格、AI 生成的买入/卖出/持有信号、多市场比较、大户扫描、风险评分	获取数据驱动的洞察，并为任何市场取得 Claude 生成的建议。
交易 (12)	限价与市价单 (GTC, GTD, FOK, FAK)、批次提交、AI 建议定价、订单状态追踪、批量取消、自然语言转策略执行、具滑价保护的仓位再平衡	以程序化或通过自然语言提示来下单与管理交易。
投资组合管理 (8)	实时仓位检视、已实现/未实现损益、总投资组合价值、集中度与多样化风险分析、链上活动日志、AI 驱动的投资组合优化（保守/平衡/积极）	随时掌握敞口状况，并让 Claude 建议调整方案。
实时监控 (7)	WebSocket 价格流、订单簿深度流、订单状态通知、执行警报、市场结算通知、订阅处理、具指数退避机制的自动重连	实时掌握信息；仪表板可可视化这些流数据。

安全与风险管理层

针对订单大小、总敞口、单一市场仓位、最小市场流动性与最大价差的可配置上限。
交易前验证与确认流程（大额订单可能需要明确的 confirm=true）。
通过令牌桶算法进行速率限制，以遵守 Polymarket 的 API 限制。
EIP-712 签名订单与基于钱包的验证（Polygon 私钥 + 地址）。

生产就绪的基础设施

MCP server 使用 Python 3.10+ 编写，可透过 pip install -e . 安装。
Web dashboard (polymarket-web 或 ./start_web_dashboard.sh) 运行于 http://localhost:8080，用于可视化配置、实时统计与市场浏览。
无模拟 – 测试套件直接调用真实的 Polymarket API，确保代码在生产环境端点下运作正常。
完整测试覆盖率 与 CI 就绪脚本 (pytest, coverage reports)。

入门指南（快速开始）

# 演示（只读） – 无需钱包
curl -sSL https://raw.githubusercontent.com/caiovicentino/polymarket-mcp-server/main/quickstart.sh | bash

# 完整安装（交易） – 建立 venv、安装依赖并执行 Claude-Desktop 整合
./install.sh               # macOS / Linux
install.bat                # Windows

编辑 .env – 设置 DEMO_MODE=true 进行只读模式，或提供 POLYGON_PRIVATE_KEY 与 POLYGON_ADDRESS 进行实盘交易。根据需要调整安全限制。

代理程序如何使用它

Claude（或任何兼容 MCP 的 LLM）向服务器发送 JSON-RPC 请求，调用如 market_analysis 或 place_limit_order 等工具名称。服务器返回结构化数据（价格、风险评分、订单确认），Claude 可将其纳入下一个推理步骤。这种往返机制实现了自然语言驱动的自主交易，同时服务器会强制执行 .env 中定义的安全策略。

适用对象

研究人员：探索 AI 驱动的预测市场策略。
量化团队：建立需要可靠桥接至 Polymarket 的自定义代理程序。
个人交易者：希望拥有 Claude 辅助进行市场发现与风险感知执行。

授权与社区

MIT 授权 – 免费供商业或个人使用。
GitHub Issues、Discussions 与 Telegram（链接于仓库中）上有活跃社区。
贡献指南与“路线图”，列出即将推出的 CI/CD、回测、多钱包支持与更丰富的 AI 分析工具。

总结

Polymarket MCP Server 是 Anthropic 的 Claude（通过 MCP 协议）与 Polymarket 预测市场生态系统之间一个真实、生产级的桥梁。它整合了强大的工具箱、安全检查与网页 UI，使其成为当今预测市场自主 AI 交易中最完整的开源堆栈之一。