AI导哈

预测市场MCP服务器

一个为LLM代理提供完整访问Polymarket预测市场的MCP服务器，支持市场发现、趋势分析、头寸监控和交易执行。

  • by Arjein
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Arjein/polymarket-mcp

使用说明

Polymarket MCP服务器

MCP（模型上下文协议）服务器，使LLM代理能够完全访问 多市场 --全球最大的预测市场。发现市场、分析趋势、监控头寸和执行交易。

34工具 · 4个API · 读+写 · 内置安全防护装置

特性

类别 工具 需要授权
🔍 市场发现 search_events, search_markets, get_event, get_gamma_market ❌
📊 实时定价 get_price, get_midpoint, get_spread, get_order_book, get_last_trade_price +批量变体 ❌
📈 分析 get_price_history, get_open_interest ❌
🏦 账户 get_positions, get_trade_history, get_activity 钱包地址
💰 交易 place_order, cancel_order, cancel_all_orders, get_open_orders, get_balance_allowance 私钥
⚙️ 市场元数据 get_tick_size, get_neg_risk, get_fee_rate，CLOB市场上市 ❌

快速开始

先决条件

安装

git clone https://github.com/Arjein/polymarket-mcp.git
cd polymarket-mcp
uv sync

配置

cp .env.example .env

对于 只读 工具（市场数据、分析）：无需配置。

对于 交易 工具：将您的凭据添加到 .env:

POLYMARKET_PRIVATE_KEY=0xYourPrivateKey
POLYMARKET_WALLET_ADDRESS=0xYourWalletAddress
POLYMARKET_DRY_RUN=true        # Start with dry-run!
POLYMARKET_MAX_ORDER_SIZE=100  # Safety limit in USD

连接到克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "polymarket": {
      "command": "uv",
      "args": ["--directory", "/path/to/polymarket-mcp", "run", "server.py"]
    }
  }
}

独立运行

uv run server.py

建筑

polymarket-mcp/
├── server.py              # MCP server entrypoint
├── clients/
│   ├── clob.py            # CLOB API (public reads + price history)
│   ├── gamma.py           # Gamma API (market/event discovery)
│   ├── data.py            # Data API (positions, trades, open interest)
│   └── auth_clob.py       # Authenticated CLOB (orders, balances)
├── tools/
│   ├── clob_tools.py      # 18 read-only CLOB tools
│   ├── gamma_tools.py     # 4 market discovery tools
│   ├── data_tools.py      # 5 analytics & account tools
│   └── trading_tools.py   # 7 authenticated trading tools
├── .env.example           # Configuration template
└── pyproject.toml         # Dependencies & metadata

API覆盖范围

API 基本URL 用途
字符大对象 clob.polymarket.com 订单簿、价格、点差、市场数据
伽马 gamma-api.polymarket.com 市场/事件发现、元数据、搜索
数据 data-api.polymarket.com 头寸、交易、活动、未平仓合约
CLOB认证 clob.polymarket.com 订单下达/取消、余额

发展

npx -y @modelcontextprotocol/inspector uv run polymarket-mcp

安全防护装置

交易工具包括内置的安全机制：

  • 干运行模式 (POLYMARKET_DRY_RUN=true)：订单被模拟并以JSON格式返回，无需执行。默认情况下启用。
  • 最大订单大小 (POLYMARKET_MAX_ORDER_SIZE)：超过此美元价值的订单将被拒绝。默认值：100美元。
  • 延迟身份验证：服务器在没有凭据的情况下启动——只读工具立即工作。Auth仅在首次调用交易工具时初始化。

工具参考

Market Discovery (4 tools)
工具 说明
search_events 按查询、标签、活动/关闭状态搜索事件
get_event 获取活动详情，包括所有儿童市场
search_markets 使用过滤器（数量、标签、状态）搜索市场
get_gamma_market 按ID或slug获取完整的市场元数据
Real-Time Pricing (10 tools)
工具 说明
get_price 代币的最佳买卖价格
get_midpoint / get_midpoints 中端市场价格（单/批）
get_spread / get_spreads 买卖价差（单/批）
get_order_book / get_order_books 全订单深度（单/批）
get_last_trade_price / get_last_trades_prices 上次执行价格（单/批）
Analytics (2 tools)
工具 说明
get_price_history 具有可配置间隔和保真度的历史时间序列
get_open_interest 市场已发行股份总数
Account Management (3 tools)
工具 说明
get_positions 当前持有量及损益明细
get_trade_history 历史执行交易
get_activity 完整的审计跟踪（交易、拆分、合并、奖励）
Trading (7 tools)
工具 说明
place_order 下达限价订单（买入/卖出、GTC/FOK/GTD/FAK）
cancel_order 取消特定订单
cancel_orders 取消多个订单
cancel_all_orders 紧急停止开关——取消一切
get_open_orders 列出所有待处理订单
get_order 获取订单状态和详细信息
get_balance_allowance 检查USDC余额和批准
CLOB Metadata (6 tools)
工具 说明
clob_health_check API健康检查
clob_server_time 服务器时间戳
get_clob_markets / get_clob_simplified_markets 浏览CLOB市场列表
get_tick_size / get_neg_risk / get_fee_rate 市场交易参数
get_market_trades_events 市场实时交易动态

示例用法

连接到Claude Desktop后，您可以问：

“目前Polymarket上最热门的市场是什么？”

“给我看看上周比特币的价格历史”

“美联储利率决策市场的订单深度是多少？”

“在超级碗市场以0.35美元的价格为100股YES股票发出模拟买入订单”

⚠️ 免责声明

此软件用于 仅用于教育和信息目的这不是财务建议。

  • 交易预测市场涉及风险。 您可能会损失部分或全部资金。
  • 作者是 不负责任 因使用本软件而产生的任何经济损失。
  • 您全权负责 为了您自己的交易决策以及遵守您所在司法管辖区的所有适用法律法规。

使用此软件即表示您承认并接受这些风险。

许可证

麻省理工学院

相关 MCP