大学足球数据MCP服务器
概述
此模型上下文协议（MCP）服务器使AI助手和应用程序能够：
- 查询高校足球综合统计数据
- 访问比赛结果、球队记录和球员统计数据
- 逐一分析播放数据和驱动器摘要
- 查看排名和获胜概率指标
- 比较团队绩效并产生见解
用户可以使用自然语言运行查询。
样本输出
问：2014赛季FCS比赛中最大的失利是什么？
A.让我来帮你找出2014年FCS最大的失误。我将查看比赛数据，重点关注FCS团队之间的比赛，在这些比赛中，团队实力存在显著差距，结果出乎意料。
数据显示，2014年FCS出现了几次明显的动荡，但最突出的是2014年9月6日华盛顿东部以52比59击败华盛顿。这一点尤其重要，因为：
- 华盛顿是Pac-12会议的FBS团队
- 比赛在华盛顿的主场（赫斯基体育场）进行
- 根据赛后统计，华盛顿东部的获胜概率仅为1.4%
- 华盛顿东区得到的59分是FCS队对阵Pac-12对手的最高得分
- 华盛顿在比赛中获得了多分的优势
该赛季其他值得注意的FCS失误包括：
- 北达科他州以34比14击败爱荷华州
- 白求恩·库克曼以14胜12负战胜FIU
- 北爱荷华州几乎击败爱荷华州（以31比23落败）
然而，考虑到以下因素，华盛顿东部对华盛顿的争夺似乎是2014年FCS赛季最大的冷门：
- 师的差异（FCS与FBS）
- FBS对手的口径（Power 5会议）
- 弱者的得分差距和进攻表现
- 作为得分最高的FCS赢得Power 5队的历史意义
- 事实上，它发生在一个充满敌意的环境中
先决条件
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面大学足球数据服务器 史密瑟里:
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 - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 添加服务器配置：
{
"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
重新启动后，您可以通过单击文本框左下角的加号来确认安装。如果成功，您将看到“从cfbd-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-extras5.
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上检查密钥是否有效
- 速率限制
- 尽可能间隔出请求 - 考虑订阅Patreon以获得更高的限制 - 对频繁访问的数据实施缓存
- 连接问题
- 验证互联网连接 - 在collegefootball data.com上查看API状态 - 确保在代码中正确处理错误
获取帮助
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。