PolyMarket MCP Server

PolyMarket MCP サーバー

PolyMarket API を通じて予測市場データにアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーは、予測市場の市場情報、価格、過去のデータを取得するための標準化されたインターフェースを実装しています。

機能

• 現在の価格と確率を含む、リアルタイムの予測市場データ
• カテゴリー、解決日、説明などを含む詳細な市場情報
• 期間（1d、7d、30d、all）をカスタマイズできる、過去の価格と出来高データ
• 組み込みのエラー処理とレート制限管理
• 簡単に利用できる、整形済みのデータ

インストール

Smithery 経由でのインストール

Smithery 経由で PolyMarket Predictions を Claude Desktop に自動的にインストールするには：

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

開発中／未公開サーバーの設定

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

ローカルでの実行

1. リポジトリをクローンし、依存関係をインストールします：

ライブラリのインストール

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

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

利用可能なツール

サーバーは次の 4 つのツールを実装しています：

• get-market-info：特定の予測市場に関する詳細情報を取得します
• list-markets：フィルタリングオプションを指定して、利用可能な予測市場を一覧表示します
• get-market-prices：現在の価格と取引情報を取得します
• get-market-history：過去の価格と出来高データを取得します

get-market-info

入力スキーマ：

{
    "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...
---

list-markets

入力スキーマ：

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

get-market-prices

入力スキーマ：

{
    "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%
---

get-market-history

入力スキーマ：

{
    "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-core
• python-dotenv>=1.0.0

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更の場合は、まず変更内容について話し合うために Issue を作成してください。