FutPicks

FutPicks MCP サーバー

サッカーデータ向けの Model Context Protocol サーバーです。各選手の出場確率と予想ファンタジーポイントを含む先発予想、試合分析、モデルの予測、公開されている実績記録を提供します。対象リーグは、LaLiga、Premier League、Serie A、Bundesliga、Ligue 1、Primeira Liga です。

すべてのツールは、HTTPS 経由で公開されている futpicks.com の REST API を呼び出します。データベースへのアクセスやシェルの使用はなく、環境変数に設定する API トークン以外のローカルシークレットもありません。先発予想、試合、実績記録のツールには、キーが一切不要です。

先発予想は確定した先発 XI と照合して公開の場で評価されるため、ツールが報告する精度は、主張ではなく測定値です。futpicks.com/onces/la-liga と同じデータを使用しています。

クイックスタート

任意の MCP クライアントに追加します（ここでは Claude Code を例にしています）。インストールは不要で、npx が取得します。

{
  "mcpServers": {
    "futpicks": {
      "command": "npx",
      "args": ["-y", "futpicks-mcp"]
    }
  }
}

次に、先発予想をリクエストします。クラブを探すには flab_teams、試合日程を確認するには flab_matches_upcoming、予想先発 XI とモデルによる試合分析を確認するには flab_match_details を使います。

Pro ツールと管理者ツールを有効にするには、キーを追加します。

{
  "mcpServers": {
    "futpicks": {
      "command": "npx",
      "args": ["-y", "futpicks-mcp"],
      "env": {
        "FUTPICKS_API_KEY": "flab_live_…"
      }
    }
  }
}

ソースからビルドする

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

ホットリロードを使ったローカル開発には、npm run dev を実行します。

環境変数

変数	必要なツール	説明
FUTPICKS_API_URL	いいえ	API のベース URL（デフォルト：https://futpicks.com）
FUTPICKS_API_KEY	データツール	データスコープの API キー（ProTier ポリシー）
FUTPICKS_OPS_TOKEN	Ops ツール	Ops スコープの API キー（管理者ポリシー。管理者のみ）

公開ツールはトークンなしで利用できます。

トークンの取得先

ウェブアプリから API キーを発行します。futpicks.com → Account → API Keys（Cuenta → Claves de API）。

• FUTPICKS_API_KEY — Data スコープのキーを作成します。flab_live_… のような形式で、Pro ティア（ProTier）のエンドポイントで使用できます。Pro ユーザーと管理者が発行できます。
• FUTPICKS_OPS_TOKEN — Ops スコープのキーを作成します。flab_ops_… のような形式で、管理者用（Ops）エンドポイントで使用できます。管理者のみが発行できます。

キーの生データは作成時に一度だけ表示されるため、すぐに環境変数にコピーしてください。キーは SHA-256 ハッシュとしてのみ保存され、有効期限を任意に設定できます。また、同じ画面から失効させることができます。失効または期限切れのキーは 401 で拒否されます。

ツール

公開ツール（認証不要）

ツール	エンドポイント	主なパラメーター
flab_picks_today	GET /api/picks/today	date?, rating?, market?
flab_pick_details	GET /api/picks/{id}	id
flab_picks_board	GET /api/picks/board	date?, league?, market?, rating?, odds/edge ranges
flab_matches_today	GET /api/matches/today	—
flab_match_details	GET /api/matches/{id}[/intelligence]	id, includeIntelligence?
flab_matches_upcoming	GET /api/matches/upcoming	days?（1–30）
flab_teams	GET /api/teams	—
flab_track_record	GET /api/track-record/filtered	market?, league?, rating?, outcome?, from?, to?
flab_health	GET /api/health	—

データツール（FUTPICKS_API_KEY が必要）

ツール	エンドポイント	主なパラメーター
flab_picks_history	GET /api/picks/history	from?, to?, league?, market?, rating?, page?, pageSize?
flab_evaluate_matches	GET /api/evaluate/matches	—
flab_evaluate_match	GET /api/evaluate/{matchId}	matchId
flab_backtest_run	POST /api/backtest/run	dateFrom, dateTo, rating?, market?, minEdge?, leagueId?
flab_export_picks	GET /api/picks/export	from?, to?, market?, rating?（CSV を返します）
flab_data_catalog	GET /api/v1/data	—

Ops ツール（FUTPICKS_OPS_TOKEN が必要、管理者専用）

ツール	エンドポイント	主なパラメーター
flab_ops_run	POST /api/v1/ops/operations/{kind}	kind、および date?／lastDays?／windowDays?／matchId?
flab_ops_status	GET /api/v1/ops/operations/{id}[/result]	id、includeResult?

flab_ops_run の種類：ingestion-runs、scoring-runs、settlement-runs、calibration-runs、 intelligence-refreshes。サーバーは Ops の POST ごとに Idempotency-Key を自動生成します。

Claude Desktop の設定

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "footballlab": {
      "command": "node",
      "args": ["C:/Users/ceja_/Desktop/Desarrollos/Furbov2/mcp-server/dist/index.js"],
      "env": {
        "FUTPICKS_API_URL": "https://futpicks.com",
        "FUTPICKS_API_KEY": "your-pro-tier-token",
        "FUTPICKS_OPS_TOKEN": "your-admin-token"
      }
    }
  }
}

ローカルでの確認

npx @modelcontextprotocol/inspector node dist/index.js

次に flab_health を呼び出してください（トークンは不要です）。稼働中のシステムステータスが返されます。

セキュリティ

• どのツールも、DB 接続文字列や appsettings のシークレットを読み取ったり、VPS 上でシェルを実行したりしません。
• すべての入力は zod で検証され、ページサイズと範囲はサーバー側で上限が設定されます。
• トークンは環境変数からのみ読み込まれ、ログに記録されることはありません。
• データ／Ops ツールは、トークンがない場合に明確なメッセージを表示して失敗します。認証なしの呼び出しにフォールバックすることはありません。
• Ops の変更操作では新しい Idempotency-Key を送信するため、API によって再試行が重複排除されます。