使用说明
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--加密货币、区块链、DeFisports--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许可证-请参阅 许可证 了解详情。
🔗 链接
- 多市场 --预测市场平台
- 模型上下文协议 --MCP规范
- MCP TypeScript SDK --官方SDK
关键词: Polymarket、MCP、模型上下文协议、预测市场、人工智能助手、Claude、Cursor、博彩赔率、加密市场、政治博彩、体育博彩、市场分析、订单簿、价格历史