caiovicentino/polymarket-mcp-server
🤖 AI-Powered MCP Server for Polymarket - Enable Claude to trade prediction markets with 45 tools, real-time monitoring, and enterprise-grade safety features
🤖 Polymarket MCP Server – PolymarketのためのAI拡張取引システム
概要 – AnthropicのClaudeがPolymarketの予測市場APIと対話できるようにする、Model Context Protocol (MCP) を実装したPythonベースのサーバーです。45種類のすぐに使える「ツール」（関数）を公開しており、Claude（またはMCP互換エージェント）が市場の発見、オーダーブックの分析、注文の配置と管理、ポートフォリオのリアルタイム監視を行えるようにします。
重要性 – 予測市場取引は、自律型エージェントにとってニッチですが成長中の分野です。PolymarketのCLOB、Gamma、WebSocketエンドポイントを安全第一のMCPサーバーでラップすることで、このプロジェクトは大規模言語モデルエージェントが構成可能なリスク制限を遵守しながら、半自律的なトレーダーとして機能することを可能にします。
主要機能（5つのツールカテゴリ）
| カテゴリ | ツール | できること |
|---|---|---|
| 市場発見 (8) | キーワード検索、トレンドリスト、カテゴリフィルタ、終了間近アラート、スポーツ＆暗号資産市場ブラウザ | 戦略や興味に一致する市場を素早く見つける。 |
| 市場分析 (10) | リアルタイム価格/スプレッド、オーダーブック深度、流動性＆出来高指標、過去価格、AI生成のBUY/SELL/HOLDシグナル、市場間比較、大口保有者スキャン、リスクスコアリング | データに基づいた洞察を得て、Claudeが生成した推奨事項をあらゆる市場で活用する。 |
| 取引 (12) | 指値・成行注文 (GTC, GTD, FOK, FAK)、一括送信、AI推奨価格、注文ステータス追跡、一括キャンセル、自然言語による戦略実行、スリッページ保護付きポジションリバランス | プログラムまたは自然言語プロンプトを通じて注文を配置・管理する。 |
| ポートフォリオ管理 (8) | リアルタイムポジション表示、実現/未実現損益、ポートフォリオ総額、集中度＆分散リスク分析、オンチェーン活動ログ、AI駆動のポートフォリオ最適化（保守的/バランス型/積極的） | エクスポージャーを常に把握し、Claudeに調整を提案させる。 |
| リアルタイム監視 (7) | WebSocket価格ストリーム、オーダーブック深度ストリーム、注文ステータス通知、実行アラート、市場決済通知、サブスクリプション管理、指数バックオフ付き自動再接続 | 情報を即座に把握。ダッシュボードでこれらのストリームを可視化。 |
安全性とリスク管理層
- 注文サイズ、総エクスポージャー、市場ごとのポジション、最小市場流動性、最大スプレッドに対する構成可能な上限設定。
- 取引前検証および確認フロー（大口注文には明示的な
confirm=trueが必要な場合がある）。 - トークンバケットアルゴリズムによるレート制限（PolymarketのAPI制限を遵守）。
- EIP-712署名注文およびウォレットベースの認証（Polygon秘密鍵 + アドレス）。
本番環境対応のインフラ
- MCP server はPython 3.10+で記述されており、
pip install -e .でインストール可能。 - Web dashboard (
polymarket-webまたは./start_web_dashboard.sh) はhttp://localhost:8080で動作し、視覚的な設定、ライブ統計、市場ブラウジングを提供。 - モックなし – テストスイートは実際のPolymarket APIにアクセスし、本番エンドポイントに対してコードが動作することを保証。
- 完全なテストカバレッジ とCI対応スクリプト (
pytest, coverage reports)。
はじめに（クイックスタート）
# デモ（読み取り専用） – ウォレット不要
curl -sSL https://raw.githubusercontent.com/caiovicentino/polymarket-mcp-server/main/quickstart.sh | bash
# フルインストール（取引） – venvの作成、依存関係のインストール、Claude-Desktop統合の実行
./install.sh # macOS / Linux
install.bat # Windows
.env を編集 – 読み取り専用の場合は DEMO_MODE=true を設定し、ライブ取引の場合は POLYGON_PRIVATE_KEY と POLYGON_ADDRESS を提供してください。必要に応じて安全制限を調整してください。
エージェントによる利用方法
Claude（またはMCP互換LLM）は、market_analysis や place_limit_order などのツール名を呼び出すJSON-RPCリクエストをサーバーに送信します。サーバーは構造化データ（価格、リスクスコア、注文確認）を返し、Claudeはそれを次の推論ステップに組み込むことができます。この往復通信により、自然言語駆動の自律取引が可能となり、サーバーは .env で定義された安全ポリシーを強制します。
想定されるユーザー
- 研究者：AI駆動の予測市場戦略を探索する方。
- クオンツチーム：Polymarketへの信頼性の高いブリッジを必要とするカスタムエージェントを構築する方。
- 個人トレーダー：市場発見とリスク管理された実行のためにClaudeを活用したい方。
ライセンスとコミュニティ
- MITライセンス – 商用・個人利用ともに無料。
- GitHub Issues、Discussions、Telegram（リポジトリからリンク）で活発なコミュニティ。
- 貢献ガイドと「ロードマップ」があり、今後のCI/CD、バックテスト、マルチウォレット対応、より高度なAI分析ツールがリストアップされています。
結論
Polymarket MCP Serverは、AnthropicのClaude（MCPプロトコル経由）とPolymarketの予測市場エコシステムを結ぶ真の本番グレードのブリッジです。豊富なツールボックス、安全チェック、Web UIを統合しており、今日の予測市場における自律型AI取引のための最も完全なオープンソーススタックの一つとなっています。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト