Odds De-vig MCP Server

The Odds APIからスポーツオッズを取得し、ブックメーカーのマージン（vig）を除去するためのMCPサーバー。

✅ 最新の改善点（v1.1.0）

• API使用量トラッキング：すべてのレスポンスにAPI呼び出しの残量が含まれるようになりました

• リトライロジック：接続問題時の自動リトライ（3回試行）

• エラーハンドリングの改善：ネットワークエラー処理の向上

• レスポンス形式：summaryとapiUsageを含む構造化されたレスポンス

機能

ツール（Tools）

1. get_sports - サポートされているスポーツのリストを取得（APIリクエストなし）

2. get_today_mlb - 本日のMLB試合を処理済みオッズで取得（経済的）

3. get_upcoming_odds - 生のオッズを取得（デフォルト：本日のMLB試合）

4. get_processed_odds - マージンが除去された処理済みオッズを取得

5. get_event_consensus - 特定のイベントのコンセンサスラインを取得

6. get_api_usage - API使用統計を取得（APIリクエストを1回実行）

リソース（Resources）

• odds://sports - サポートされているスポーツのリスト（APIリクエストなし）

• odds://today-mlb - 本日のMLB試合の処理済みオッズ

• odds://processed - マージンなしの処理済みオッズ（デフォルト：本日のMLB）

マージン除去の方法

1. Proportional（比例法）- デフォルト

最もシンプルで一般的に使用される方法：

fair_probability = implied_probability / total_implied_probability

2. Power（冪乗法/Shin）

より複雑で、結果の数を考慮した方法：

fair_probability = implied_probability^n / total_implied_probability^(n-1)

3. Additive（加算法）

マージンをすべての結果に均等に分配します：

fair_probability = implied_probability - (total_vig / number_of_outcomes)

インストールと実行

# Установка зависимостей
npm install

# Сборка
npm run build

# Запуск
npm start

# Разработка
npm run dev

設定

環境変数ODDS_API_KEYを設定するか、デフォルトのキーを使用します：

export ODDS_API_KEY=your_api_key_here

⚠️ API制限

重要： The Odds APIは無料プランでは月500リクエストの制限があります！

リクエストを節約するための最適化：

• デフォルトでは本日のMLB試合のみをリクエスト

• get_sportsはAPIリクエストなしでハードコードされたリストを返す

• get_today_mlbはデータを取得する最も経済的な方法

• すべてのリクエストはAPI使用量をログに記録

推奨事項：

• テストにはget_today_mlbを使用

• テストでは1日20リクエストに制限

• get_api_usageで使用量を監視

使用方法

スポーツのリストを取得（APIリクエストなし）

{
  "tool": "get_sports"
}

本日のMLB試合を取得（経済的）

{
  "tool": "get_today_mlb",
  "arguments": {
    "deVigMethod": "proportional"
  }
}

処理済みオッズの取得

{
  "tool": "get_processed_odds",
  "arguments": {
    "sport": "americanfootball_nfl",
    "deVigMethod": "proportional",
    "removeOutliers": true,
    "minBookmakers": 3
  }
}

コンセンサスラインの取得

{
  "tool": "get_event_consensus",
  "arguments": {
    "eventId": "event_id_from_api",
    "deVigMethod": "power"
  }
}

データ構造

ProcessedEvent

interface ProcessedEvent {
  id: string;
  sportKey: string;
  sportTitle: string;
  commenceTime: string;
  homeTeam: string;
  awayTeam: string;
  bookmakers: ProcessedBookmaker[];
  consensusLine?: {
    homeTeamFairOdds: number;
    awayTeamFairOdds: number;
    averageVig: number;
  };
}

ProcessedOutcome

interface ProcessedOutcome {
  name: string;
  americanOdds: number;
  decimalOdds: number;
  impliedProbability: number;
  fairProbability: number; // После удаления маржи
}

API制限

重要： 月500リクエストの制限！

現在の最適化：

• MLBに焦点を当てる（毎日試合がある）

• 本日の試合のみリクエスト

• スポーツのハードコードリスト

• 各リクエストのログ記録

モニタリング：

{
  "tool": "get_api_usage"
}

返り値：

{
  "requestsUsed": "15",
  "requestsRemaining": "485",
  "monthlyLimit": 500,
  "eventsFound": 12
}

次のステップ

1. Polymarket CLOB APIサーバー - Polymarketからデータを取得するため

2. 比較サーバー - ラインの比較とアービトラージ検出のため

3. ニュース/SERPサーバー - ニュースとコンテキストの取得のため