Polymarket MCP

Polymarket MCP

一款用于 Polymarket 的独立 Rust MCP 服务：提供带来源链接的市场简报、公开发现、精确的 CLOB V2 订单簿、钱包分析、实时市场状态、SQLite 记录与回放、成交模拟，以及经过安全门控的可选交易功能。

默认的 research 配置无需 API 密钥或钱包。它提供 30 个公开／实时工具，不会声明或接受对身份验证交易工具的调用。另有精简的 11 工具 chatgpt 配置，无状态、不接触凭据，并可通过 Streamable HTTP 使用，还可选择内嵌市场卡片。

一分钟内完成安装

macOS 或 Linux：

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/beejmaxx/polymarket-mcp-rs/main/scripts/install.sh | sh
polymarket-mcp-rs doctor

Windows PowerShell：

irm https://raw.githubusercontent.com/beejmaxx/polymarket-mcp-rs/main/scripts/install.ps1 | iex
polymarket-mcp-rs doctor

也可以使用包管理器：

brew install beejmaxx/tap/polymarket-mcp-rs

scoop bucket add beejmaxx https://github.com/beejmaxx/scoop-bucket
scoop install beejmaxx/polymarket-mcp-rs

然后将其添加到客户端：

codex mcp add polymarket -- polymarket-mcp-rs
# or
claude mcp add polymarket -- polymarket-mcp-rs

每个 GitHub release 都附带预编译二进制文件和一键安装的 polymarket-mcp.mcpb 包。有关 Claude Desktop、VS Code、源码构建、自定义数据库路径和 Windows 的详情，请参阅安装指南。

为什么选择此服务

• 已验证的替代方案：提供 46 个工具，涵盖公开数据、实时订单簿、研究工作流和可选账户操作，并通过自动化实时审计与全部 25 个 Python 演示工具进行比对。
• 可直接用于回答的工作流：单个市场简报整合元数据、可执行订单簿、历史数据、成交影响、来源 URL、时间戳和限制说明；钱包及明确的负风险事件摘要可避免不必要的工具调用链。
• 精确的数值边界：十进制金融数值和 256 位 ID 在 JSON 中始终保留为字符串，避免浮点数和整数精度丢失。
• 有状态的市场研究：Rust 在内部维护重建后的订单簿和数据流健康状态，而不是将每次行情更新都发送给模型。
• 可靠的回放：SQLite 存储由此进程采集的观测数据，跟踪丢弃的更新，并且绝不会将其描述为完整的交易所历史记录。
• 安全的默认设置：默认不提供交易工具；是否公开这些工具与是否启用修改操作是两个独立的决定。
• 运维简单：单个二进制文件，支持 stdio 或无状态 Streamable HTTP、结构化错误、健康检查和 Prometheus 端点、离线／在线诊断工具、优雅关闭、每日生产环境金丝雀检查、容器、校验和、SBOM 和发布溯源信息。

一个实用的入门提示词

找出交易量最高的五个活跃 Polymarket 市场。对每个市场，展示当前结果价格、流动性、价差、订单簿失衡情况，以及买入 100 股的预估滑点。说明数据限制，不要推荐交易。

其他演示提示词见 docs/DEMO.md。

工具配置

配置	工具数	适用场景
chatgpt	11	面向托管客户端的精简、无状态公共研究接口
core	20	公共 REST 发现、图书、钱包、可直接用于回答的分析和模拟
research（默认）	30	核心功能，加实时监控和本地录制／回放
trading	36	核心功能，加经过身份验证的账户、用户事件流和交易操作
all	46	同时包含研究和交易功能

使用 --tool-profile research 或 POLYMARKET_TOOL_PROFILE=research 选择配置。隐藏工具会同时从 tools/list 和调度中移除。选择 trading 或 all 只会公开工具定义；修改订单仍需设置 POLYMARKET_ENABLE_TRADING=true，并配置签名者、本地限额以及每项操作的确认。公共 HTTP 仅接受 chatgpt 或 core，并会构建一个按设计忽略凭据的应用实例。

运行 polymarket-mcp-rs tools 可查看默认目录，运行 polymarket-mcp-rs --tool-profile all tools --json 可查看完整架构。分组参考请参阅 docs/TOOLS.md。

架构

MCP client (stdio or Streamable HTTP)
        |
        v
tool profile + typed MCP schemas
        |
        v
validation and stable output mapping
   |              |                |                 |
Gamma/Data/    CLOB REST      realtime books      SQLite + trading
public APIs    exact books    WebSocket health    replay / audit

市场 WebSocket 引擎会先通过 CLOB REST 为每个受监控的代币载入初始数据，然后应用完整快照和增量价格变更。经过身份验证的配置还可以单独监控账户订单和交易事件。连接状态、重连、特定来源的计数器、本地接收时间、数据流时效、错误和录制间断都会明确显示。SQLite 写入通过有界通道和专用写入线程完成；当 MCP EOF、SIGINT 或 SIGTERM 到来时，活动录制会在监控停止前刷新。

配置

变量	默认值	用途
POLYMARKET_TOOL_PROFILE	research	chatgpt、core、research、trading 或 all
POLYMARKET_MCP_DB	OS 应用程序数据目录	SQLite 录制和审批审计数据库
POLYMARKET_WS_URL	生产环境市场 WebSocket	覆盖完整 WebSocket URL
POLYMARKET_WS_PROXY	未设置	无需身份验证的 socks5://host:port WebSocket 代理
HTTPS_PROXY / HTTP_PROXY	取决于环境	HTTP API 客户端使用的代理
RUST_LOG	info	stderr 日志筛选

macOS 上的默认数据库位于 ~/Library/Application Support/polymarket-mcp/，Linux 上位于 $XDG_DATA_HOME/polymarket-mcp/（或 ~/.local/share/polymarket-mcp/），Windows 上位于 %LOCALAPPDATA%\polymarket-mcp\。如果未设置 POLYMARKET_WS_PROXY，公共市场 WebSocket 也会使用 ALL_PROXY=socks5://...；在通常不受限的网络中，无需设置这两个变量。此服务不收集遥测数据。

交易需要单独主动启用

请先阅读 SECURITY.md 和 docs/THREAT_MODEL.md。至少需要：

export POLYMARKET_TOOL_PROFILE=all
export POLYMARKET_ENABLE_TRADING=true
export POLYMARKET_PRIVATE_KEY=0x...
export POLYMARKET_MAX_ORDER_PUSD=100
export POLYMARKET_SIGNATURE_TYPE=eoa

支持 EOA、legacy Proxy、Gnosis Safe 和 POLY_1271 配置。preview_order 会执行策略和当前市场规则检查，并创建一个有效期为五分钟、只能使用一次的审批。place_order 会使用该审批，并要求 confirm=true；批量下单需要 PLACE_BATCH。取消操作也需要单独确认。审批状态转换会在提交前持久化；对于结果不明确的网络操作，系统绝不会将其报告为可安全重试。账户读取和用户事件监控不会在不通知的情况下启用断开连接时自动取消的心跳。

开发与证据

需要 Rust 1.90 或更高版本：

cargo fmt --check
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked --all-features
cargo test --locked --test live_api -- --ignored --nocapture

常规测试无需联网，并会将编译后的可执行文件作为真实的 stdio MCP 子进程启动。被忽略的测试套件会测试当前生产环境中的 Gamma、Data、CLOB REST、钱包、扫描、WebSocket、录制、回放和模拟路径；它绝不会下单。工具目录都有已提交的黄金合约，发布标签会针对五种操作系统／架构目标重新构建。

实时语义替换审计会通过 MCP 启动此服务和 Python 参考服务，映射每个 Python 演示工具，并在出现 Rust 错误或违反不变量时失败：

python3 scripts/parity_harness.py

• Python 替换矩阵
• 从 Python 服务迁移
• 相同代币的 Python 对比
• 最新实时兼容性审计摘要
• ChatGPT 设置
• 只读 HTTP 部署
• 兼容性
• 合约稳定性
• 路线图
• 贡献指南
• 隐私
• 支持
• 启动与演示工具包

本软件提供市场基础设施，不提供交易建议或财务建议。