MCP 服务器

PolyMarket MCP Server

启用与 PolyMarket API 的交互，以获取预测市场数据，例如市场信息、价格和历史数据，并具有强大的错误处理和速率限制管理。

Tools

get-market-info

Get detailed information about a specific prediction market

list-markets

Get a list of prediction markets with optional filters

get-market-prices

Get current prices and trading information for a market

get-market-history

Get historical price and volume data for a market

README

PolyMarket MCP 服务器

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

特性

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

安装

通过 Smithery 安装

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

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": "<insert poly market api key>",
                "FUNDER": "<insert polymarket wallet address"
            }
        }
    }

本地运行

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

安装库

uv pip install -e .

运行

通过 json 文件将 Claude 客户端与 MCP 工具连接并安装软件包后，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

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

Key=your_api_key_here
Funder=poly market wallet address

通过 json 文件将 Claude 客户端与 MCP 工具连接后，运行服务器：在 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 或 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...
---

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
    }
}

示例响应：

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
---

get-market-prices

输入模式：

{
    "market_id": {
        "type": "string",
        "description": "市场 ID 或 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%
---

get-market-history

输入模式：

{
    "market_id": {
        "type": "string",
        "description": "市场 ID 或 slug"
    },
    "timeframe": {
        "type": "string",
        "description": "历史数据的时间段",
        "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
---