Nflverse

@pipeworx/nflverse

来自 nflverse 的 NFL 比赛逐回合数据、球员赛季统计、球队比赛记录、包含赛果和投注盘口的赛程，以及每周伤病报告，涵盖 1999 年至当前赛季。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1779+ 个实时数据源的 MCP 网关。此集成独立且非官方，与上游提供方无关联，未获其认可，也非其发布。

工具

• nfl_player_season_stats(player, season, season_type?)：一名球员的赛季总数据（传球、冲球、接球、防守、踢球、回攻、EPA、CPOE、目标占比、梦幻积分）。可按姓名或 nflverse/GSIS ID 查询。值为零的字段不会显示。
• nfl_team_game_log(team, season)：一支球队某个赛季的比赛记录。每场比赛包含对手、主场/客场、最终比分、胜/负，以及传球、冲球、EPA、失误、犯规、擒杀和踢球总数据。
• nfl_play_by_play(game_id, quarter?, play_type?, limit?)：一场比赛的所有回合，包含进攻档数和推进距离、场上位置、回合类型、码数、官方回合描述、相关球员、比分、EPA 和获胜概率。
• nfl_schedule(season, week?, team?)：某个赛季的比赛。每场比赛包含比赛 ID、日期、开球时间、比分、加时赛情况、收盘让分和总分、场馆、屋顶和场地类型、天气、首发四分卫、教练和裁判。
• nfl_injuries(season, team?, week?, player?)：官方每周伤病报告条目（比赛状态和训练参与情况），按周从近到远排列。涵盖 2009 年至当前赛季。

每个响应都包含 data_as_of，即该回答所依据的 nflverse 赛季文件的最后修改时间，以及 source 和 licence。未匹配到任何内容的查询会返回 found: false 及一条消息。未知球队代码或格式错误的比赛 ID 会被拒绝，并返回列出有效格式的错误。

身份验证

无需密钥。

数据源

• nflverse、nflverse-data：比赛逐回合数据、球员和球队统计、赛程及伤病报告，由 nflverse 项目根据 NFL 比赛数据编制。

许可证。 nflverse-data 仓库采用 Creative Commons Attribution 4.0 International (CC-BY-4.0) 发布。允许重复使用，包括商业用途，但须注明出处。每个响应都包含 licence: "CC-BY-4.0 — data by nflverse (https://github.com/nflverse)"。每次调用都会在请求时读取已发布的赛季文件。本工具包不会保留副本。

给后来者的说明：

• 球队代码遵循 nflverse 规范：LA 表示 Rams（也接受 LAR 作为别名）、LAC、LV、WAS。搬迁前的球队在旧赛季中沿用旧代码（OAK、SD、STL）。
• 一个赛季从 9 月持续到次年 2 月，因此 2024 赛季包含在 2025 年进行的季后赛。
• 比赛逐回合数据是大型表格，每个赛季约为 19 MB 的 gzip 压缩文件、100 MB 的 CSV 文件。数据会以流式方式读取，并筛选出单场比赛。行按 game_id 排序，因此扫描到超出所请求比赛的位置后就会停止。
• 当前赛季的文件会由 nflverse 在赛季期间更新，data_as_of 也会随之更新。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "nflverse": {
      "url": "https://gateway.pipeworx.io/nflverse/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/nflverse/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 等网关级工具。因此，你看到的工具数量会多于表中所列：目前，单个工具包端点除了该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，并且是当天情况的权威依据。

这是有意设计的，并非意外的多路复用。元工具能让限定范围的连接回答此工具包无法涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义带来的上下文成本超过路由的价值，请改为只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1779+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/nfl_player_season_stats \
  -H 'Content-Type: application/json' \
  -d '{"player":"Joe Burrow","season":2024}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/nfl_player_season_stats。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需通过网关中转：

{
  "mcpServers": {
    "nflverse": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nflverse"]
    }
  }
}

或者直接运行，确认它能启动：

npx -y @pipeworx/mcp-nflverse

它通过 stdin/stdout 使用 MCP 协议，并且只会针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接提供的任何共享元工具。源代码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Nflverse data" })

网关会选择合适的工具，并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT