PolyMarket MCP 服务器
模型上下文协议 (MCP) 服务器，通过 PolyMarket API 提供对预测市场数据的访问。该服务器实现了一个标准化接口，用于检索预测市场的市场信息、价格和历史数据。
特征
- 实时预测市场数据，包括当前价格和概率
- 详细的市场信息，包括类别、决议日期和描述
- 具有可自定义时间范围（1 天、7 天、30 天、全部）的历史价格和数量数据
- 内置错误处理和速率限制管理
- 清晰的数据格式，方便使用
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 PolyMarket Predictions：
npx -y @smithery/cli install polymarket_mcp --client claude
克劳德桌面
- 在 MacOS 上：
~/Library/Application\ Support/Claude/claude_desktop_config.json - 在 Windows 上：
%APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"polymarket-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
"run",
"polymarket-mcp" //or src/polymarket_mcp/server.py
],
"env": {
"KEY": "<insert poly market api key>",
"FUNDER": "<insert polymarket wallet address"
}
}
}
本地运行
- 克隆存储库并安装依赖项：
安装库
跑步
通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，Claude 应该可以看到服务器的 mcp 工具：
您可以通过以下方式自行运行服务器：在 polymarket-mcp repo 中：
uv run src/polymarket_mcp/server.py
*如果您想与服务器一起运行服务器检查器：
npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.py
- 使用您的 PolyMarket API 密钥创建一个
.env文件：
Key=your_api_key_here
Funder=poly market wallet address
通过 json 文件将 Claude 客户端与 MCP 工具连接后，运行服务器：在 alpha-vantage-mcp repo 中： uv run src/polymarket_mcp/server.py
可用工具
该服务器实现了四个工具：
get-market-info ：获取有关特定预测市场的详细信息list-markets ：列出可用的预测市场并附带过滤选项get-market-prices ：获取当前价格和交易信息get-market-history ：获取历史价格和交易量数据
获取市场信息
输入模式：
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
}
}
响应示例：
Title: Example Market
Category: Politics
Status: Open
Resolution Date: 2024-12-31
Volume: $1,234,567.89
Liquidity: $98,765.43
Description: This is an example prediction market...
---
上市市场
输入模式：
{
"status": {
"type": "string",
"description": "Filter by market status",
"enum": ["open", "closed", "resolved"]
},
"limit": {
"type": "integer",
"description": "Number of markets to return",
"default": 10,
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Number of markets to skip (for pagination)",
"default": 0,
"minimum": 0
}
}
响应示例：
Available Markets:
ID: market-123
Title: US Presidential Election 2024
Status: Open
Volume: $1,234,567.89
---
ID: market-124
Title: Oscar Best Picture 2024
Status: Open
Volume: $234,567.89
---
获取市场价格
输入模式：
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
}
}
响应示例：
Current Market Prices for US Presidential Election 2024
Outcome: Democratic
Price: $0.6500
Probability: 65.0%
---
Outcome: Republican
Price: $0.3500
Probability: 35.0%
---
获取市场历史
输入模式：
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
},
"timeframe": {
"type": "string",
"description": "Time period for historical data",
"enum": ["1d", "7d", "30d", "all"],
"default": "7d"
}
}
响应示例：
Historical Data for US Presidential Election 2024
Time Period: 7d
Time: 2024-01-20T12:00:00Z
Price: $0.6500
Volume: $123,456.78
---
Time: 2024-01-19T12:00:00Z
Price: $0.6300
Volume: $98,765.43
---
错误处理
该服务器包括针对各种场景的全面错误处理：
- 速率限制（429 个错误）
- 无效的 API 密钥（403 错误）
- 无效的市场 ID（404 错误）
- 网络连接问题
- API 超时条件（30 秒超时）
- 格式错误的响应
错误消息以清晰、人类可读的格式返回。
先决条件
- Python 3.9 或更高版本
- httpx>=0.24.0
- mcp-核心
- python-dotenv>=1.0.0
贡献
欢迎贡献代码！欢迎提交 Pull 请求。对于重大变更，请先提交一个 issue 来讨论您想要修改的内容。