PolyMarket MCP Server

PolyMarket MCP 服务器

模型上下文协议 (MCP) 服务器，通过 PolyMarket API 提供对预测市场数据的访问。该服务器实现了一个标准化接口，用于检索预测市场的市场信息、价格和历史数据。

特征

• 实时预测市场数据，包括当前价格和概率
• 详细的市场信息，包括类别、决议日期和描述
• 具有可自定义时间范围（1 天、7 天、30 天、全部）的历史价格和数量数据
• 内置错误处理和速率限制管理
• 清晰的数据格式，方便使用

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 PolyMarket Predictions：

克劳德桌面

• 在 MacOS 上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

本地运行

1. 克隆存储库并安装依赖项：

安装库

跑步

通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，Claude 应该可以看到服务器的 mcp 工具：

您可以通过以下方式自行运行服务器：在 polymarket-mcp repo 中：

*如果您想与服务器一起运行服务器检查器：

2. 使用您的 PolyMarket API 密钥创建一个.env文件：

通过 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 ：获取历史价格和交易量数据

获取市场信息

输入模式：

响应示例：

上市市场

输入模式：

响应示例：

获取市场价格

输入模式：

响应示例：

获取市场历史

输入模式：

响应示例：

错误处理

该服务器包括针对各种场景的全面错误处理：

• 速率限制（429 个错误）
• 无效的 API 密钥（403 错误）
• 无效的市场 ID（404 错误）
• 网络连接问题
• API 超时条件（30 秒超时）
• 格式错误的响应

错误消息以清晰、人类可读的格式返回。

先决条件

• Python 3.9 或更高版本
• httpx>=0.24.0
• mcp-核心
• python-dotenv>=1.0.0

贡献

欢迎贡献代码！欢迎提交 Pull 请求。对于重大变更，请先提交一个 issue 来讨论您想要修改的内容。