【技术文档摘要】

PolyMarket MCP 服务器

这是一个通过 PolyMarket API 提供预测市场数据访问的 Model Context Protocol (MCP) 服务器。该服务器实现了用于检索市场信息、价格和历史数据的标准接口。

<a href="https://glama.ai/mcp/servers/c255m147fd"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=3294996445,1894959560&fm=3081&app=3081&f=PNG?w=760&h=400" alt="PolyMarket Server MCP 服务器" /> </a>

特性

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

安装

通过 Smithery 安装

要通过 Smithery 自动安装 PolyMarket 预测市场：

npx -y @smithery/cli install polymarket_mcp --client claude

Claude Desktop

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

<summary>开发/未发布服务器配置</summary>

    "mcpServers": {
        "polymarket-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
            "run",
            "polymarket-mcp" //或 src/polymarket_mcp/server.py
            ],
            "env": {
                "KEY": "<插入 poly market api 密钥>",
                "FUNDER": "<插入 polymarket 钱包地址>"
            }
        }
    }

本地运行

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

安装库

uv pip install -e .

运行

在连接了 Claude 客户端与 MCP 工具并通过 json 文件安装了包之后，Claude 应该能看到服务器的 mcp 工具：

你可以通过以下方式自行运行服务器： 在 polymarket-mcp 仓库中：

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

2. 创建一个包含你的 PolyMarket API 密钥的 .env 文件：

Key=your_api_key_here
Funder=poly market 钱包地址

在连接了 Claude 客户端与 MCP 工具并通过 json 文件后，运行服务器： 在 alpha-vantage-mcp 仓库中：uv run src/polymarket_mcp/server.py

可用工具

服务器实现了四个工具：

• get-market-info：获取特定预测市场的详细信息
• list-markets：列出可用的预测市场，并提供过滤选项
• get-market-prices：获取当前价格和交易信息
• get-market-history：获取历史价格和成交量数据

get-market-info

输入模式：

{
    "market_id": {
        "type": "string",
        "description": "市场 ID 或别名"
    }
}

示例响应：

标题：示例市场
类别：政治
状态：开放
解决日期：2024-12-31
成交量：$1,234,567.89
流动性：$98,765.43
描述：这是一个示例预测市场...
---

list-markets

输入模式：

{
    "status": {
        "type": "string",
        "description": "按市场状态筛选",
        "enum": ["open", "closed", "resolved"]
    },
    "limit": {
        "type": "integer",
        "description": "返回的市场数量",
        "default": 10,
        "minimum": 1,
        "maximum": 100
    },
    "offset": {
        "type": "integer",
        "description": "跳过的市场数量（用于分页）",
        "default": 0,
        "minimum": 0
    }
}

示例响应：

可用市场：

ID：market-123
标题：2024美国总统选举
状态：开放
成交量：$1,234,567.89
---

ID：market-124
标题：2024奥斯卡最佳影片
状态：开放
成交量：$234,567.89
---

get-market-prices

输入模式：

{
    "market_id": {
        "type": "string",
        "description": "市场 ID 或别名"
    }
}

示例响应：

2024美国总统选举的当前市场价格

结果：民主党
价格：$0.6500
概率：65.0%
---

结果：共和党
价格：$0.3500
概率：35.0%
---

get-market-history

输入模式：

{
    "market_id": {
        "type": "string",
        "description": "市场 ID 或别名"
    },
    "timeframe": {
        "type": "string",
        "description": "历史数据的时间段",
        "enum": ["1d", "7d", "30d", "all"],
        "default": "7d"
    }
}

示例响应：

2024美国总统选举的历史数据
时间段：7d

时间：2024-01-20T12:00:00Z
价格：$0.6500
成交量：$123,456.78
---

时间：2024-01-19T12:00:00Z
价格：$0.6300
成交量：$98,765.43
---

错误处理

服务器包含了针对各种情况的全面错误处理：

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

错误消息以清晰易读的格式返回。

先决条件

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

贡献

欢迎贡献！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。