Polymarket MCP Server

Polymarket MCP 服务

⚠️ 注意：Quantish 即将停止运营。 Quantish 平台（quantish.live）即将关闭。此 MCP 服务可自托管，并将继续独立运行，但 Quantish 团队将不再维护或更新此项目。如果你正在预测市场领域开发项目，并需要实时数据基础设施，请查看 polynode.dev。

用于在 Polymarket 预测市场交易的可自托管 MCP 服务。

概述

此软件包提供了一个 MCP（Model Context Protocol）服务，可让 AI Agent 通过 Polygon 网络在 Polymarket 预测市场进行交易。

功能

• 完整的 Polymarket 交易功能 - 在任意 Polymarket 市场买入或卖出
• Polygon 钱包管理 - 生成和管理钱包，并集成 Safe
• 免 Gas 交易 - 大多数操作使用 Polymarket 的中继器（无需 MATIC）
• 兼容 MCP - 可与 Claude、Cursor 及任何 MCP 客户端配合使用
• 可自托管 - 可运行在 Railway、Fly.io 或任何 Node.js 主机上

快速开始

git clone https://github.com/joinQuantish/polymarket-mcp
cd polymarket-mcp
npm install

环境变量

变量	必需	说明
DATABASE_URL	是	PostgreSQL 连接字符串
ENCRYPTION_KEY	是	用于钱包加密的 32 字节十六进制字符串
POLYGON_RPC_URL	是	Polygon RPC 端点
BOT_SIGNING_SECRET	否	用于受信任 Bot HMAC 身份验证的密钥
PORT	否	服务端口（默认为 3000）

生成加密密钥

# Generate ENCRYPTION_KEY (32 bytes = 64 hex chars)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# Generate BOT_SIGNING_SECRET (for trusted bot auth)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

数据库设置

任何 PostgreSQL 数据库均可使用。可选方案：

提供商	说明
Railway	添加 PostgreSQL 服务，并从变量中复制 DATABASE_URL
Supabase	在 supabase.com 提供免费套餐，从 Settings > Database 复制连接字符串
Neon	neon.tech 提供无服务器 Postgres，并有免费套餐
本地 Docker	docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres

设置 DATABASE_URL 后运行：

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

运行服务

# Development
npm run dev

# Production
npm run build
npm start

可用工具

账户和钱包

工具	说明
request_api_key	使用新钱包创建账户（或恢复现有账户）
setup_wallet	部署 Safe 钱包并设置授权
get_wallet_status	检查钱包部署和授权状态
get_balances	获取 USDC/MATIC 余额
get_deposit_addresses	获取充值地址（EVM、Solana、BTC）
export_private_key	导出钱包私钥
import_private_key	导入现有钱包

交易

工具	说明
place_order	下达买入/卖出订单
cancel_order	取消未完成的订单
cancel_all_orders	取消所有未完成的订单
get_orders	获取订单历史记录
execute_atomic_orders	原子性地执行多个订单
get_orderbook	获取市场买单/卖单
get_price	获取市场中间价

持仓

工具	说明
get_positions	获取你的持仓
sync_positions	从 Polymarket API 同步持仓
get_claimable_winnings	检查可赎回的收益
claim_winnings	领取已结算市场的收益
get_onchain_shares	获取所有 ERC-1155 持有资产（包括获赠资产）

转账和兑换

工具	说明
transfer_usdc	发送桥接 USDC
transfer_native_usdc	发送 Circle 原生 USDC
transfer_shares	发送 ERC-1155 份额
send_matic	从 EOA 发送 MATIC
swap_tokens	通过 LI.FI 兑换代币
get_swap_quote	获取兑换报价

API 密钥

工具	说明
list_api_keys	列出你的 API 密钥
create_additional_api_key	创建新的 API 密钥
revoke_api_key	撤销 API 密钥

注意： 市场搜索工具（search_markets、get_market、get_active_markets）可通过 Discovery MCP 使用。

API 格式

服务器在 /mcp 提供 JSON-RPC 2.0 端点：

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_balances",
      "arguments": {}
    },
    "id": 1
  }'

MCP 客户端配置

Claude Desktop / Cursor

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "x-api-key: YOUR_API_KEY"
      ]
    }
  }
}

安全

回访用户

出于安全考虑，回访用户（已有 externalId）必须通过身份验证才能获取新的 API 密钥。可选方式：

1. 使用现有 API 密钥 - 如果已保存
2. HMAC 身份验证（仅限受信任的机器人）- 使用 BOT_SIGNING_SECRET 签名：

   signature = HMAC-SHA256(externalId:timestamp, BOT_SIGNING_SECRET)
   

3. 新建账户 - 使用不同的 externalId

开发

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

资源

• GitHub：joinQuantish/polymarket-mcp
• Discovery MCP：joinQuantish/quantish-discovery
• Polymarket 文档：docs.polymarket.com

许可证

本项目采用 PolyForm Noncommercial License 1.0.0 许可。

可免费用于个人用途、研究和非商业目的。 商业用途需获得 Quantish Inc. 的明确许可。商业许可请联系 [email protected]。

---

由 Quantish Inc. 构建