Prediction Market MCP

🚀 prediction-markets-mcp

このModel Context Protocol (MCP)サーバーは、複数のプラットフォームからリアルタイムの予測市場データを提供します。統一されたインターフェースを通じて、現在のオッズ、価格、および市場情報をクエリすることができます。

🚀 クイックスタート

このサーバーを使用することで、複数の予測市場プラットフォームからのデータを統一的に取得できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 複数プラットフォーム対応：暗号通貨ベースと従来型の予測市場の両方をクエリできます。
• リアルタイムデータ：実際の市場から現在のオッズと価格を取得できます。
• キーワード検索：特定のキーワードやトピックで市場をフィルタリングできます。
• 統一インターフェース：異なるプラットフォーム間で一貫したデータ形式を提供します。
• エラーハンドリング：APIの失敗やネットワーク問題を適切に処理します。
• 型安全性：完全なTypeScriptサポートと包括的な型定義があります。

📦 インストール

前提条件

• Node.js (v18以上)
• npmまたはyarn

セットアップ

1. リポジトリをクローンします：

git clone <repository-url>
cd prediction-markets-mcp

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

💻 使用例

サーバーの起動

MCPサーバーを起動します：

node build/index.js

サーバーはstdioで実行され、MCP互換のクライアントと統合できます。

APIエンドポイント

サーバーは1つのツール get-prediction-markets を提供します。

パラメーター

• keyword (文字列、必須)：市場をフィルタリングする検索用語
  • 最大長：50文字
  • 例："trump", "election", "supreme court"

クエリ例

// Trump関連の市場を検索
{
  "keyword": "trump"
}

// 選挙市場を検索
{
  "keyword": "election"
}

// 最高裁判所関連の市場を検索
{
  "keyword": "supreme court"
}

レスポンス形式

サーバーは予測市場データを以下の形式で返します。

Polymarketの市場

**Polymarket: Will Trump win the 2024 election?**
Yes: 45.2% | No: 54.8%

PredictItの市場

**PredictIt: Which party will win the 2025 gubernatorial election in Virginia?**
Democratic: 89.0% | Republican: 11.0%

📚 ドキュメント

データソース

Polymarket API

• ベースURL：https://clob.polymarket.com/markets
• 形式：JSON
• オッズ表示：パーセンテージ (例: 65.2%)
• データ：市場の質問、アクティブ状態、トークン価格

PredictIt API

• ベースURL：https://www.predictit.org/api/marketdata/all/
• 形式：JSON
• オッズ表示：ドル金額 (例: $0.65)
• データ：市場名、契約、取引価格、ステータス

開発

プロジェクト構造

prediction-markets-mcp/
├── src/
│   └── index.ts          # メインサーバーの実装
├── build/                # コンパイルされたJavaScript出力
├── package.json          # 依存関係とスクリプト
├── tsconfig.json         # TypeScriptの設定
└── README.md            # このファイル

主要コンポーネント

型定義

// Polymarketの型
type Market = {
  question: string;
  active: boolean;
  archived: boolean;
  tokens: Token[];
};

// PredictItの型
type PredictItMarket = {
  id: number;
  name: string;
  shortName: string;
  contracts: PredictItContract[];
  status: string;
};

コア関数

• getPolymarketPredictionData()：Polymarketのデータを取得して処理します。
• getPredictItMarkets()：すべてのPredictIt市場を取得します。
• makeApiRequest()：適切なヘッダーを持つHTTPリクエストを処理します。

ビルド

# 開発用ビルド
npm run build

# 必要に応じてウォッチモード
npm run dev

テスト

サーバーを手動でテストするには：

1. サーバーを起動します：

node build/index.js

2. MCPクライアントを通じてテストリクエストを送信するか、APIエンドポイントを直接テストします。

🔧 技術詳細

トラブルシューティング

一般的な問題

市場が見つからない

• 原因：キーワードが過度に具体的であるか、一致する市場が存在しない
• 解決策：より広範なキーワードを試すか、市場の可用性を確認する
• 例："特定の候補者名" の代わりに "election" を使用する

開発セットアップ

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 適用可能な場合はテストを追加します
5. プルリクエストを送信します

コードスタイル

• すべての新しいコードにTypeScriptを使用します
• 既存の命名規則に従います
• 公開関数にJSDocコメントを追加します
• 送信する前にすべてのビルドが成功することを確認します

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

サポート

問題や質問については：

1. トラブルシューティングセクションを確認します
2. 既存のGitHubの問題を確認します
3. 詳細な情報を含む新しい問題を作成します