M
MCP-CFBD服
@lenwood/cfbd-mcp-server
0 Stars
355 次浏览
lenwood
更新于 2026-08-23
一个MCP服务器，提供对克劳德桌面中大学橄榄球数据API来源的大学橄榄球统计数据的访问。
该服务暂未提供标准配置，请参考 README 手动接入
服务介绍
大学橄榄球数据 MCP 服务器
这是一个 MCP 服务器实现，它提供了在 Claude Desktop 内访问来自 College Football Data API 的大学橄榄球统计数据的功能。
概述
此模型上下文协议 (MCP) 服务器使 AI 助手和应用程序能够：
- 查询全面的大学橄榄球统计数据
- 访问比赛结果、球队记录和球员统计
- 分析逐场数据和比赛摘要
- 查看排名和胜率指标
- 比较球队表现并生成见解
用户可以使用自然语言运行查询。
示例输出
问：2014 赛季 FCS 比赛中最大的冷门是哪一场？
答：让我帮您找到 2014 年最大的 FCS 冷门。我将浏览比赛数据，重点关注 FCS 球队之间的那些存在显著实力差距且结果出乎意料的比赛。
数据显示，2014 年 FCS 有多场值得注意的冷门，但其中最突出的一场是东华盛顿队于 2014 年 9 月 6 日以 52-59 击败华盛顿队。这场比赛特别引人注目是因为：
- 华盛顿队是一支来自 Pac-12 联盟的 FBS 球队
- 比赛是在华盛顿主场（哈士奇体育场）进行的
- 根据赛后统计数据，东华盛顿队获胜的概率仅为 1.4%
- 东华盛顿队得到的 59 分是对阵 Pac-12 对手时 FCS 球队得分最高的
- 在比赛前，华盛顿队被看好能赢多个分数
该赛季其他值得注意的 FCS 冷门包括：
- 北达科他州立大学以 34-14 击败爱荷华州立大学
- 贝瑟恩-库克曼大学以 14-12 击败佛罗里达国际大学
- 北艾奥瓦大学几乎击败了艾奥瓦大学（最终以 31-23 输掉）
然而，考虑到以下因素，东华盛顿战胜华盛顿似乎是 2014 年 FCS 赛季的最大冷门：
- 分区差异（FCS 对 FBS）
- FBS 对手的级别（Power 5 联盟）
- 弱队的得分差和进攻表现
- 作为对 Power 5 球队得分最高的 FCS 胜利之一的历史意义
- 比赛发生在客场，在一个不利的环境中举行
前提条件
安装
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 College Football Data Server：
npx -y @smithery/cli install cfbd --client claude
- 克隆此仓库：
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server
- 创建并激活虚拟环境：
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- 安装依赖项：
uv pip install -e .
- 在项目根目录下创建一个
.env文件，并添加您的 API 密钥：
CFB_API_KEY=your_api_key_here
手动安装
- 克隆此仓库：
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server
- 创建并激活虚拟环境：
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- 安装依赖项：
uv pip install -e .
- 在项目根目录下创建一个
.env文件，并添加您的 API 密钥：
CFB_API_KEY=your_api_key_here
使用方法
运行服务器
启动服务器：
uv run cfbd-mcp-server
与 Claude Desktop 连接
-
打开您的 Claude Desktop 配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
添加服务器配置：
{
"mcpServers": {
"cfbd-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/cfbd-mcp-server",
"run",
"cfbd-mcp-server"
],
"env": {
"CFB_API_KEY": "xxx",
"PATH": "/full/path/to/python"
}
}
}
}
- 关闭然后重新启动 Claude Desktop
重启后，您应该会在文本框的右下角看到一个小锤子图标。将鼠标悬停在图标上时，您会看到可用的 MCP 工具数量。
安装后的更新
- 下载更新的文件
cd cfbd-mcp-server
git pull
- 卸载现有的包：
uv pip uninstall cfbd-mcp-server
- 删除现有的构建工件和元数据
对于 Windows：
rmdir /s /q build dist
del /s /q *.egg-info
对于 macOS：
rm -rf build dist *.egg-info
- 安装修订后的包及其依赖项
uv pip install -e .
uv sync --dev --all-extras
uv run cfbd-mcp-server
- 关闭并重新启动 Claude Desktop
功能
资源
访问所有端点的模式文档：
schema://games- 比赛信息和得分schema://records- 球队赛季记录schema://games/teams- 详细的球队比赛数据schema://plays- 每个回合的信息schema://drives- 进攻回合总结和结果schema://play/stats- 单个回合的统计数据schema://rankings- 各项排名中的球队排名schema://metrics/wp/pregame- 赛前胜率schema://game/box/advanced- 高级数据统计
工具
直接查询端点：
get-games- 获取比赛数据get-records- 获取球队记录get-games-teams- 访问球队比赛统计数据get-plays- 查询每个回合的数据get-drives- 分析进攻回合信息get-play-stats- 查看回合统计数据get-rankings- 查看球队排名get-pregame-win-probability- 查看胜率get-advanced-box-score- 访问详细的比赛统计数据和分析
提示
预构建的分析模板：
analyze-game- 获取特定比赛的详细分析analyze-team- 综合单一球队分析analyze-trends- 分析整个赛季的趋势compare-teams- 比较两支球队的表现analyze-rivalry- 分析历史对手对决
API 限制
大学橄榄球数据 API 是免费使用的，但有限制请求速率：
- 免费层：每分钟限制请求次数
- CFBD Patreon 订阅者 可获得更高的请求速率
- 使用高效的查询模式以避免达到限制
- 优雅地处理请求速率错误
开发
项目结构
cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
└── cfbd_mcp_server/
├── .env
├── __init__.py
├── cfbd_schema.py
├── schema_helpers.py
└── server.py
设置开发环境
- 克隆仓库
- 安装开发依赖项：
uv pip install -e ".[dev]"
- 运行测试：
pytest
贡献代码
- 分叉仓库
- 创建一个功能分支
- 提交你的更改
- 推送到你的分叉
- 提交一个拉取请求
故障排除
常见问题
-
API 密钥错误
- 确认你的 API 密钥在
.env和claude_desktop_config.json文件中正确设置 - 检查密钥在 collegefootballdata.com 上是否有效
- 确认你的 API 密钥在
-
速率限制
- 尽可能分散请求
- 考虑订阅 Patreon 以获得更高的限制
- 对经常访问的数据实现缓存
-
连接问题
- 验证互联网连接
- 检查 collegefootballdata.com 的 API 状态
- 确保代码中有适当的错误处理
获取帮助
- 在 GitHub 上打开一个 issue
- 查看 API 文档
- 检查 College Football Data Discord
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
致谢
- College Football Data 提供的 API
- Model Context Protocol 提供的 MCP 规范
