NBA Prop Lab

PropLab MCP サーバー

PropLab 向けの Model Context Protocol サーバーです。NBA と WNBA の選手プロップ分析を提供します。試合開始前にモデルが公開する毎日のボード、公式ボックススコアに基づいて判定された公開成績、ポジション別の対戦相手ディフェンス、使用率、審判、選手リサーチを利用できます。

利用方法は 2 つあります。

• リモートサーバー：すぐに使え、インストール不要でキーも必要ありません。 https://nbaproplab.com/mcp
• ローカル stdio パッケージ。このリポジトリからビルドします。API キーが必要なバックテストとオンデマンドのピック評価が追加されます。npm にはまだ公開されていません。

データは情報提供を目的としたスポーツ分析であり、ベッティングの助言ではありません。PropLab は賭けを受け付けず、スポーツブックへのリンクも提供せず、結果を保証しません。また、過去の結果が将来を予測するものではありません。

リモートサーバー（推奨）

Streamable HTTP、ステートレス、認証不要です。すべてのツールは読み取り専用で、nbaproplab.com に表示されているものと同じ公開データを返します。

Claude（claude.ai、デスクトップ、モバイル）： 設定 → コネクタ → カスタムコネクタを追加します。名前： PropLab。URL：https://nbaproplab.com/mcp。認証：なし。

Claude Code：

claude mcp add --transport http proplab https://nbaproplab.com/mcp

Codex：

codex mcp add proplab --url https://nbaproplab.com/mcp

または ~/.codex/config.toml に記述します。

[mcp_servers.proplab]
url = "https://nbaproplab.com/mcp"

Streamable HTTP に対応する他のクライアントでも、同じ URL を指定できます。

ツール

ツール	パラメーター	戻り値
daily_board	league（nba または wnba）	次の試合日程に向けて公開された選手プロップボード（選手、スタッツ、ライン、方向、ティア、モデルスコア）と、前回のボードの結果
track_record	league?、tier?（Premium または Standard）、from?、to?	ティアおよびスタッツ別の確定成績。公開成績には Premium ティア（premiumHitRate、goodPicks）と Standard（marginalPicks）が含まれます。overall* フィールドには、公開されない内部評価も含まれます。2026-04-03 より前の日付はバックテストです
defense_vs_position	league	各チームがガード、フォワード、センターに許す得点、リバウンド、アシストをリーグ平均との比較で表示し、ディフェンシブレーティング、ペース、順位も含みます
usage_leaders	league	今シーズンの使用率順に選手を表示し、直近 10 試合の使用率、出場時間、得点も含みます
nba_today	—	今日の NBA の試合と開始時刻、昨日のスコア、順位表
games	date?（yyyy-MM-dd）	指定日の NBA と WNBA の試合（デフォルト：今日、米国東部時間）
referee_assignments_today	—	NBA が試合当日の朝に発表した後の、今日の各 NBA 試合の審判団
referees	—	今シーズンの NBA 審判と担当試合数、リーグ平均と比較した 1 試合あたりのファウル数
search_players	query	名前で NBA と WNBA の選手を検索します。アクセント記号は省略できます（「Jokic」で Jokić が見つかります）
player_research	playerId	直近の試合記録、各スポーツブックの現在のプロップラインと的中率、負傷状況、次の試合の状況、その選手に対するモデルのピック

プロンプトの例：

• 「センターに最も多くのリバウンドを許している NBA チームはどこですか？ その中に今日試合があるチームはありますか？」
• 「PropLab が公開している WNBA の Premium ティアの成績は、4 月以降、スタッツ別にどうなっていますか？」
• 「Jokic を検索して、直近 10 試合と負傷状況を表示してください。」

たとえば league: "nfl" のような無効な引数を指定すると、有効な値を説明するツールエラーが返されます。

ローカル stdio パッケージ

npm にはまだ公開されていないため、このリポジトリからビルドします。

git clone https://github.com/Khavel/proplab-mcp.git
cd proplab-mcp
npm install
npm run build      # compiles src/index.ts → dist/index.js

次に、ビルド先への絶対パスを指定して、MCP クライアントに登録します。

{
  "mcpServers": {
    "proplab": {
      "command": "node",
      "args": ["/absolute/path/to/proplab-mcp/dist/index.js"],
      "env": {
        "PROPLAB_API_KEY": "…"
      }
    }
  }
}

PROPLAB_API_KEY は任意です。指定しなくても公開ツールは引き続き利用できます。ホットリロードを使ったローカル開発には、npm run dev を実行してください。

環境変数

変数	必須となる用途	説明
PROPLAB_API_URL	いいえ	API のベース URL（デフォルト：https://nbaproplab.com）
PROPLAB_API_KEY	バックテスト、ピック、リサーチツール	Bearer API キー

キーは nbaproplab.com → アカウント → API キー で発行できます。作成時に一度だけ表示され、同じ画面から取り消せます。

ツール

公開、キー不要：

ツール	エンドポイント	主なパラメーター
proplab_track_record	GET /api/v1/track-record	league?, tier?, statType?, from?, to?
proplab_dashboard	GET /api/v1/dashboard/today	date?, league?
proplab_games	GET /api/v1/games	date?
proplab_search_players	GET /api/v1/players/search	q
proplab_system_status	GET /api/v1/health	—

PROPLAB_API_KEY が必要：

ツール	エンドポイント	主なパラメーター
proplab_backtest_summary	GET /api/v1/backtest/summary	from?, to?, league?
proplab_backtest_daily	GET /api/v1/backtest/daily	from?, to?, league?
proplab_backtest_by_rating	GET /api/v1/backtest/by-rating	from?, to?, league?
proplab_backtest_by_stat	GET /api/v1/backtest/by-stat	from?, to?, league?
proplab_pick_details	GET /api/v1/picks/{id}	id
proplab_evaluate_pick	POST /api/v1/picks/evaluate	playerName, statType, line, direction, opponentTeam?
proplab_player_research	GET /api/v1/research/player/{playerId}	playerId

ローカルで確認する

npx @modelcontextprotocol/inspector node dist/index.js

次に、キー不要でライブのシステムステータスを返す proplab_system_status を呼び出してください。

データとプライバシー

• リモートサーバー： 状態を保持せず、会話の内容を保存しません。各ツール呼び出しの引数（リーグ、日付、選手名または ID）のみを受信し、ウェブサーバーは標準のアクセスログを保持します。
• ローカルパッケージ： HTTPS 経由で公開 nbaproplab.com API を呼び出し、キーは環境変数からのみ読み取り、ログには記録しません。データベースの認証情報やアプリの設定を読み取るツールはなく、シェルも起動しません。
• 入力は zod で検証され、レスポンスは 40,000 文字で切り詰められます。proplab_evaluate_pick を除くすべてのツールは読み取り専用です。このツールは仮想のピックを採点し、何も保存しません。
• プライバシーポリシー： nbaproplab.com/legal/privacy。 責任あるギャンブルについて： nbaproplab.com/responsible-gambling。

サポート

github.com/Khavel/proplab-mcp/issues でイシューを作成してください。