预测市场查询服务

用于查询Polymarket预测市场的MCP服务器,提供实时赔率、市场数据、价格历史和订单簿访问。

  • by rafael-pina
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 rafael-pina/polymarket-mcp

使用说明

Polymarket MCP服务器

一个强大的 MCP(模型上下文协议)服务器 用于查询 多市场 预测市场。直接从您的AI助手访问实时赔率、市场数据、价格历史和订单簿。

🎯 这是什么?

此MCP服务器支持以下AI助手 克劳德, 光标和其他MCP兼容工具,以与Polymarket的预测市场API互动。通过自然语言查询实时市场赔率、跟踪价格走势、分析订单簿并按类别探索市场。

✨ 特性

工具 说明
list_markets 列出所有Polymarket预测市场并分页
search_markets 按关键字搜索市场(问题和描述)
get_market 按ID获取特定市场的详细信息
get_event 获取所有子市场组合在一起的事件详细信息
get_events_by_category 按类别(政治、加密、体育等)过滤市场
list_categories 列出所有可用的市场类别
get_trending_markets 通过交易量或价格变动发现热门市场
get_price_history 任何市场的历史价格/赔率数据
get_order_book 实时订单深度(出价和要价)

📦 安装

# Clone the repository
git clone https://github.com/yourusername/poly-mcp.git
cd poly-mcp

# Install dependencies
npm install

# Build the project
npm run build

🚀 用法

运行服务器

# Production mode
npm start

# Development mode (with hot reload)
npm run dev

# MCP Inspector (for testing)
npm run client

添加到游标IDE

将其添加到您的光标MCP设置文件中(~/.cursor/mcp.json):

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/poly-mcp/dist/index.js"]
    }
  }
}

添加到Claude桌面

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

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/poly-mcp/dist/index.js"]
    }
  }
}

🛠️ 工具参考

list_markets

列出Polymarket支持分页的预测市场。

参数 类型 默认值 说明
limit number 10 市场数量(1-100)
active boolean - 按活动状态筛选
closed boolean - 按关闭状态筛选
offset number 0 分页偏移量

例子: “列出Polymarket上的20个活跃市场”


search_markets

按关键字匹配问题和描述搜索市场。

参数 类型 默认值 说明
query 字符串 必需的 搜索查询
limit number 10 结果数(1-50)
active boolean - 按活动状态筛选
closed boolean - 按关闭状态筛选

例子: “搜索比特币预测市场”


get_market

获取特定市场的详细信息。

参数 类型 说明
market_id string 要获取的市场ID

例子: “获取市场ID 0x的详细信息…”


get_event

获取一个包含所有子市场的活动。活动将相关市场组合在一起。

参数 类型 说明
slug string 事件段符(例如。, presidential-election-winner-2024)
event_id string 事件ID
list_events boolean 改为列出可用事件
limit number 要列出的事件数(默认值:10)

例子: “在Polymarket上给我看总统选举活动”


get_events_by_category

按类别筛选预测市场,以便进行重点探索。

参数 类型 默认值 说明
category enum 必需的 类别过滤器(见下文)
limit number 10 事件数(1-50)
active boolean true 按活动状态筛选
closed boolean false 按关闭状态筛选

可用类别:

  • politics --选举、政府、政治事件
  • crypto --加密货币、区块链、DeFi
  • sports --NFL、NBA、足球等
  • world --国际关系、地缘政治
  • entertainment --音乐、电视、名人
  • economy --GDP、市场、商业
  • science --技术、人工智能、空间、气候
  • legal --法院案件、法律
  • racing --F1、纳斯卡、赛车运动

例子: “在Polymarket上展示政治市场”


list_categories

列出筛选市场的所有可用类别。

例子: “Polymarket上有哪些类别?”


get_trending_markets

发现按活动指标排序的趋势市场。

参数 类型 默认值 说明
sort_by enum volume24hr 排序指标
limit number 10 市场数量(1-50)

排序选项:

  • volume24hr --24小时交易量
  • volume1wk --每周交易量
  • oneDayPriceChange --24小时价格变动
  • oneWeekPriceChange --每周价格变动

例子: “按24小时交易量显示最热门的市场”


get_price_history

获取历史价格/赔率数据以进行市场分析。

参数 类型 默认值 说明
market_id 字符串 必需的 市场ID
outcome_index number 0 结果指数(0=是)
interval enum 1m 时间范围

间隔: 1d, 1w, 1m, 3m, 1y, max

例子: “显示过去一个月0x市场的价格历史记录”


get_order_book

获取显示当前出价和要价的实时订单深度。

参数 类型 默认值 说明
market_id 字符串 必需的 市场ID
outcome_index number 0 结果指数(0=是)

例子: “给我看看0x市场的订单簿…”

💡 查询示例

配置后,您可以询问您的AI助手:

  • “向我展示支持率超过50%的政治市场”
  • “目前加密货币市场的趋势是什么?”
  • “搜索特朗普预测市场”
  • “获取10万美元比特币市场的价格历史”
  • “列出所有体育博彩市场”
  • “总统选举市场的订单深度是多少?”

提示模板

快速提示您尝试使用AI助手:

# Quick market check
What does Polymarket say about [TOPIC]? Show me the odds.

# Cross-source validation
News reports say [EVENT]. Check Polymarket and tell me if the
smart money agrees.

# Find opportunities
Find markets closing in the next 24 hours with 90%+ odds on one side.

🔧 发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Test with MCP Inspector
npm run client

📄 API来源

此服务器使用以下Polymarket API:

  • API伽马 (gamma-api.polymarket.com)--市场和事件数据
  • API法规 (clob.polymarket.com)--订单簿和价格历史

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📜 许可证

MIT许可证-请参阅 许可证 了解详情。

🔗 链接


关键词: Polymarket、MCP、模型上下文协议、预测市场、人工智能助手、Claude、Cursor、博彩赔率、加密市场、政治博彩、体育博彩、市场分析、订单簿、价格历史