FutPicks

FutPicks MCP 服务

足球数据模型上下文协议服务：包含每名球员首发概率和预期 Fantasy 积分的可能首发阵容、比赛分析、模型预测和公开追踪记录——覆盖 LaLiga、Premier League、Serie A、Bundesliga、Ligue 1 和 Primeira Liga。

每个工具都会通过 HTTPS 调用公开的 futpicks.com REST API。无需访问数据库、无需使用 shell，也无需在环境中设置 API 令牌以外的本地密钥。阵容、比赛和追踪记录工具完全不需要密钥。

我们会公开根据已确认首发十一人对阵容预测进行评分，因此工具报告的准确率是经过衡量的，而非声称的。数据与 futpicks.com/onces/la-liga 相同。

快速开始

将其添加到任意 MCP 客户端（此处以 Claude Code 为例）——无需安装，npx 会自动获取：

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

然后请求可能的首发阵容：使用 flab_teams 查找俱乐部，使用 flab_matches_upcoming 获取赛程，再使用 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	运维工具	运维范围 API 密钥（仅管理员可用的 Admin 策略）

公开工具完全不需要令牌。

如何获取令牌

在 Web 应用中创建 API 密钥：futpicks.com → Account → API Keys（Cuenta → Claves de API）。

• FUTPICKS_API_KEY — 创建一个 Data 范围的密钥。其格式类似 flab_live_…，可用于 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?、赔率/优势范围
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	—

运维工具（需要 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。服务会为每个运维 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（无需令牌）——它应返回实时系统状态。

安全性

• 没有任何工具会读取数据库连接字符串、appsettings 密钥，或通过 shell 连接 VPS。
• 所有输入都使用 zod 验证；页大小和范围均由服务端限制。
• 令牌仅从环境变量读取，绝不会记录到日志中。
• 缺少令牌时，数据/运维工具会显示明确消息并失败——绝不会回退到未验证身份的调用。
• 运维变更会发送新的 Idempotency-Key，以便 API 对重试请求进行去重。