TheRundown Data MCP

官方 TheRundown Data MCP

这是 TheRundown 官方源代码仓库。aigeon-ai/therundown 是非官方项目。

0.4.0 源码候选版本注册了 75 个公开 REST 操作工具、四个有界的实际 WebSocket 捕获工具，以及六个现有便捷工具。它使用官方 MCP SDK 和 Node.js 22+。COVERAGE.md 列出了确切路由、别名、已退役/私有接口的排除情况和传输限制。

托管账户连接地址为 https://mcp.therundown.io/oauth/mcp；旧版 / 和 /mcp 可在已认证的请求头中接受 Product API 密钥。2026-10-03 的最近一次实时验证发现版本为 0.3.0，包含六个工具。这个扩展候选版本尚未部署，也未公开列出。个人连接不等于目录列表。独立的文档 MCP https://docs.therundown.io/mcp 无法返回 Product 价格。

ChatGPT 使用 Streamable HTTP。每次捕获都会打开一个真实的上游 WebSocket，最多监听五秒、50 条消息或 256 KiB，然后关闭。它不是持续运行的后台数据流。频道、快照和恢复限制请参阅 COVERAGE.md，部署要求请参阅 HOSTED.md。

匿名元数据和 ping 不会调用 Product。每个数据工具都需要本地密钥身份验证，或 OAuth 路由上的已连接账户。请勿将凭据放入提示词、URL、源代码、日志和浏览器包中。

下方的历史源代码 ZIP 仍为 0.2.3，不包含此候选版本。目前没有已发布的 npm 包。该 ZIP 仅支持 stdio；npm start 不会启动 HTTP 适配器。

下载带版本号的源代码包，验证其 SHA-256 校验和，然后解压。官方 ZIP 大小为 41,072 字节，SHA-256 为 cb0a0841aa040f049ffddec5b5fa2436cb9de721a30a3bd53270132db7204025。ZIP 清单用于验证包中包含的每个源文件。ZIP 中的 README 由 BUNDLE-README.md 生成；此仓库的 README 还包含仓库设置材料。在解压后的 ZIP 目录中：

npm ci --ignore-scripts
npm test

若要运行检出的源代码，请在此仓库中使用 Node.js 22+：

npm ci --ignore-scripts
npm test

如需为 Claude Desktop 手动配置本地连接，请在支持的位置将以下内容添加到 claude_desktop_config.json，然后重启客户端。请使用 Node.js 22+ 和服务的绝对路径；此源代码 ZIP 不是 .mcpb 桌面扩展：

{
  "mcpServers": {
    "therundown-data": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/therundown-data-mcp-0.2.3/server.mjs"],
      "env": { "THERUNDOWN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

对于 Cursor，请使用全局配置文件 ~/.cursor/mcp.json，并确保启动 Cursor 的环境中有可用的密钥：

{
  "mcpServers": {
    "therundown-data": {
      "type": "stdio",
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/therundown-data-mcp-0.2.3/server.mjs"],
      "env": { "THERUNDOWN_API_KEY": "${env:THERUNDOWN_API_KEY}" }
    }
  }
}

客户端参考：本地 MCP 服务、Cursor。

请在本地替换路径和密钥。若可用，请使用客户端的密钥存储或继承的环境变量。请勿提交已填入内容的客户端配置。服务会从其进程环境中读取 THERUNDOWN_API_KEY，并且只将其作为 X-TheRundown-Key 发送；密钥绝不会被接受为工具参数。如果没有密钥，进程仍可用于发现 MCP 元数据；调用 Product 工具时会返回经过净化的 missing_credentials 错误，且不会发起网络请求。

原有的六个便捷工具如下：

工具	功能	不适合用于发现的情况
list_sports	列出当前公开的体育项目 ID 和名称。	不要根据目录中的记录推断某项运动有赛事或赔率覆盖。
list_affiliates	列出当前公开的博彩商 ID 和名称。	不要将其用作证明某家博彩商提供所需体育项目或市场的依据；已停用的 27 不在其中。
list_markets	列出市场定义，或某项运动在指定日期的市场。	不要将定义视为已开放的赔率；按日期发现市场时不接受 live。
list_events	查找某项运动的带日期赛事摘要和可用市场 ID。	不要凭记忆或相似名称的结果选择赛事；请先确认确切的参赛方、日期和时区。
get_main_lines	获取指定确切赛事 ID 的各博彩商已开放主盘口。	不要在调用 list_events 之前调用它，也不要用它搜索赛事；它要求使用返回的确切 ID。
list_futures	列出范围限定的期货赛事板块，包含公开赛程、结算和已开放主盘口字段。	不要将其用于普通的按日期赛事发现，也不要假设仅凭目录或结算状态就能证明该板块已完全结算。

list_markets 保留目录发现功能，也可以发现某个 sport_id 和 date 可用的市场；按日期发现时不接受 live，因为该端点不会对实时市场进行分类。赛事查询始终使用 main_line=true、hide_closed=true 和 include=all_periods。list_futures 是 Ultra+ 赛事端点，使用范围限定的默认值 [1141] 和 [19,23]、不透明游标分页、公开赛程／结算字段，以及不含盘口 ID 的各博彩商已开放主盘口。按日期查询的赛事工具默认市场为 [1,2,3]，博彩商为 [19,23]。请显式传入实时市场 [41,42,43]。已停用的博彩商 27 会被拒绝，也不在发现结果中。

首次对话

Use TheRundown to list current sports and affiliates. Find MLB (sport 3).
For today's UTC date, list events with market_ids [1,2,3]
and affiliate_ids [19,23]. Select an event ID from that response and
call get_main_lines with the same filters.
Show the source URL, each book's line value and price updated_at,
and the returned usage headers. Explain empty results without inventing odds.

npm test 可离线运行。若要检查实际的 Product API 数据，请私下设置 THERUNDOWN_API_KEY 并运行 npm run smoke。默认检查 MLB 的赛前市场 [1,2,3] 和博彩商 [19,23]。免费版包含延迟的赛前赔率，不包含实时赔率、特殊／替代盘口和历史数据；来源目录中的记录并不代表你有权访问这些数据。

使用符合条件的密钥时，THERUNDOWN_SMOKE_LIVE=1 npm run smoke 还会请求实时市场 [41,42,43]。THERUNDOWN_SMOKE_DATE=YYYY-MM-DD 和 THERUNDOWN_SMOKE_SPORT_ID 用于选择按日期限定的范围。若要进行范围有限的 Ultra+ 赛事检查，请设置 THERUNDOWN_SMOKE_FUTURES=1，并指定 40（PGA）或 41（Formula 1）等体育项目；它只会请求市场 1141 和博彩商 19,23。检查时限为 60 秒，会验证已审核的来源工具清单，并报告其 UTC 检查时间、范围、所选赛事 ID、来源 URL、用量和数量。请确保 status: "ok"、来源工具清单完整，且赛事／主盘口数量为正数。数据为空表示结果不确定，进程以 2 退出。这些请求需主动启用，且会计量用量。

每个请求均受用量、API 方案延迟和授权范围限制。目录、按日期查询的市场、赛事和主盘口页面会在本地分页，因此每一页都会重新获取快照，并单独计量。list_futures 使用 API 上游的不透明游标和页面限制；每个游标页面仍是一个计量请求，并且当 has_more 为 true 时，只代表赛事列表的一部分。结果会公开安全的来源 URL、检索时间戳、API 用量响应头，以及每个赔率的 updated_at；检索时间戳并不能证明赔率是最新的。

Agent 简介和错误（自 0.2.1 起）

通过 MCP 资源读取 therundown://brief，获取当前 Build with AI 规则和首次对话说明。初始化时也会返回相同的说明；这两种操作都不会调用 Product API。

HTTP 失败时，除了安全的来源 URL、检索时间和用量标头外，还会返回 status、plan、missing_entitlement、required_plan、retry_after（秒）、remaining_points、monthly_remaining_points 和 limit_reason。如果 API 未提供可识别的值，字段将保持 null。服务不会根据某项功能遭拒来猜测当前套餐。不会返回原始上游错误正文，错误也不会触发自动重试。

成功但结果为空时，会保留正常的 data 结构，并添加包含代码、说明和请求范围的 empty。带日期的结果会报告运动项目、日期和日期边界偏移量（为零时使用 UTC）；超出现有结果范围的页面会与空赛程分别标识。赔率为空并不能证明该项目没有覆盖数据。

请参阅设置指南、DESIGN.md、身份验证和计费。如需了解当前公开契约和 ID，请阅读 OpenAPI 规范、体育项目目录、市场目录、联盟目录、TheRundown llms.txt和文档 llms.txt。