myersparkathleticzone-mcp

myersparkathleticzone-mcp

适用于 Myers Park High School（Mustangs）体育项目的 MCP 服务 — 提供赛程、球队、名单、教练、新闻和比赛直播链接。

无需凭据。 此服务读取的所有内容均为公开信息。无需登录、API 密钥或浏览器扩展，也无需进行任何配置即可使用。

由 AI 开发和维护。请自行斟酌使用。

安装

npx myersparkathleticzone-mcp

也可以在 MCP 宿主的配置中设置：

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

工具

工具	功能
mpaz_list_teams	查询学校某一年的球队，以及其他工具所需的球队 ID
mpaz_resolve_team	将宽泛的名称（“varsity football”）解析为球队 ID
mpaz_get_schedule	查询所有球队即将举行的赛事
mpaz_get_team_schedule	查询一支球队的完整赛季赛程
mpaz_get_scores	查询一支球队的比赛结果，并从学校角度标明胜、负或平
mpaz_get_roster	查询一支球队的教练组和球员
mpaz_list_news	查询近期新闻
mpaz_list_videos	查询带有 NFHS Network 直播链接的比赛
mpaz_list_photo_galleries	查询已发布的照片集
mpaz_healthcheck	检查网站是否可访问且可解析

所有工具均为只读；此服务不会执行任何写入操作。

限定球队的工具需要数字球队 ID 和运动项目 slug，且球队 ID 会因学年而异。请使用 mpaz_resolve_team 解析，而不要猜测 — 过期的 ID 会使网站返回 Team … Not Found 页面（HTTP 200），客户端会检测并报告此情况。

配置

以下两项均为可选：

变量	默认值	用途
MPAZ_SITE_URL	https://www.myersparkathleticzone.com	指向其他 Athletic Zone 学校网站
MPAZ_SCHOOL_ID	10150	GoFan/PlayOn 学校 ID，用于区分本校球队和对手

该网站是 PlayOn Sports / SportsEngine “Athletic Zone”平台上的一个租户，因此设置这两项即可让服务指向该平台上的其他学校。已验证 Ballantyne Ridge（https://www.ballantyneridgeathleticzone.com，学校 ID 为 21785）以及 Myers Park。

托管部署仅支持 Myers Park。 托管版（mint / claude.ai connector）运行在静态出口允许列表之后，该列表仅允许访问 www.myersparkathleticzone.com，因此在此处将 MPAZ_SITE_URL 设置为其他学校会导致所有调用失败，并显示“Could not reach”。只有通过本地 stdio 安装（npm / .mcpb）才能指向其他学校。

已知限制

这些是上游网站本身的特性，并非错误；工具会在输出中说明，而不会猜测：

• 缺失的比分表示未知，绝不表示 0。 上游分别存储双方比分，因此只录入一方的比赛（3-null、null-4）很常见。只有双方比分都存在时才会推导 result。
• Myers Park 很少记录比分。 目前观察到的所有已完成比赛的比分均为 null，因此某个赛季可能只返回没有结果的赛程 — 这是学校的数据录入情况，并非故障。
• 往届赛季的数据覆盖不完整，且取决于日历时间。 尽管各球队页面仍会提供往届赛季数据，Myers Park 的 /schedule 在往届年份为空，因此 mpaz_list_teams 会改用运动项目页面上的跨年球队选择器。该选择器按球队而非运动项目 slug 索引，因此只能通过当前处于赛季中的球队访问 — 这意味着休赛期项目的往届数据无法访问，且全年可访问的项目会发生变化。结果会附带 coverage 说明，列出已搜索的范围；列表为空并不能证明学校没有组建球队。
• 大多数球队会公布教练信息，但不会公布球员信息，因此名单为空属于正常情况。
• 全校赛程仅涵盖一段即将举行赛事的时间范围，并非完整赛季 — 请改用 mpaz_get_team_schedule。
• 直播链接指向 NFHS Network，而非托管的视频片段 — 时长始终为 0。

工作原理

该网站是一个完全由服务器渲染的 Next.js 应用，其自身的 /api/* 路由仅供服务器使用，并会拒绝外部请求。数据包含在页面的 React Server Components flight 负载中，因此该服务器会在请求页面时添加 RSC: 1 标头，并从中提取嵌入的实体。

docs/ATHLETIC-ZONE-API.md 记录了捕获的请求／响应格式、路由、失败模式以及已排除的可能性。

开发

npm install
npm run build
npm test

许可证

MIT