NBA Prop Lab

PropLab MCP Server

适用于 PropLab 的模型上下文协议服务：NBA 和 WNBA 球员道具分析。你可以获取模型在开赛前发布的每日推荐，以及根据官方技术统计评定的公开战绩、防守对位数据、使用率、裁判信息和球员研究。

有两种使用方式：

• 远程服务：即刻可用，无需安装，也无需密钥。 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 比赛的裁判组；联盟会在比赛日早晨公布安排
referees	—	本赛季的 NBA 裁判，包括执法场次、场均犯规数及其与联盟平均值的比较
search_players	query	按姓名搜索 NBA 和 WNBA 球员，无需输入变音符号（输入「Jokic」即可找到 Jokić）
player_research	playerId	近期比赛记录、各博彩公司当前的盘口及命中率、伤病状态、下一场比赛背景，以及模型对该球员的推荐

示例提示词：

• “哪些 NBA 球队允许中锋抢下最多篮板？它们今天有人比赛吗？”
• “自 4 月以来，PropLab 发布的 WNBA Premium 等级表现如何？按统计类别列出。”
• “搜索 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 → Account → API keys 中生成。密钥在创建时只会显示一次，也可以在同一页面撤销。

工具

公开，无需密钥：

工具	端点	关键参数
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），Web 服务器会保留标准访问日志。
• **本地软件包：**它通过 HTTPS 调用公开的 nbaproplab.com API，且只从环境变量读取密钥，绝不会记录密钥。没有任何工具会读取数据库凭据或应用设置，也不会打开 shell。
• 输入会使用 zod 验证，响应会截断至 40,000 个字符。除 proplab_evaluate_pick 外，所有工具均为只读；该工具会为假设的投注选项评分，但不会存储任何内容。
• 隐私政策：nbaproplab.com/legal/privacy。 负责任博彩：nbaproplab.com/responsible-gambling。

支持

请在 github.com/Khavel/proplab-mcp/issues 提交问题。