College Football Data MCP Server

基本能力

产品定位

College Football Data MCP Server 是一个专门用于查询和分析美国大学橄榄球数据的服务，旨在为 AI 助手和应用程序提供全面的统计数据和分析工具。

核心功能

• 查询全面的大学橄榄球统计数据
• 访问比赛结果、球队记录和球员统计数据
• 分析逐场比赛数据和进攻回合摘要
• 查看排名和胜率指标
• 比较球队表现并生成洞察

适用场景

• 体育数据分析
• 大学橄榄球比赛研究
• 球队和球员表现比较
• 历史比赛数据分析
• 胜率预测和趋势分析

工具列表

• get-games - 检索比赛数据
• get-records - 获取球队记录
• get-games-teams - 访问球队比赛统计数据
• get-plays - 查询逐场比赛数据
• get-drives - 分析进攻回合信息
• get-play-stats - 查看比赛统计数据
• get-rankings - 检查球队排名
• get-pregame-win-probability - 查看胜率
• get-advanced-box-score - 访问详细的比赛统计和分析

常见问题解答

1. API Key 错误
2. 验证 API 密钥是否正确设置在 .env 和 claude_desktop_config.json 文件中

3. 检查密钥在 collegefootballdata.com 上是否有效

4. 速率限制

5. 尽可能分散请求
6. 考虑 Patreon 订阅以获得更高的限制

7. 为频繁访问的数据实现缓存

8. 连接问题

9. 验证互联网连接
10. 在 collegefootballdata.com 检查 API 状态
11. 确保代码中有适当的错误处理

使用教程

使用依赖

• Python 3.11 或更高版本
• UV 包管理器（推荐）
• College Football Data API 密钥

安装教程

通过 Smithery 安装

npx -y @smithery/cli install cfbd --client claude

手动安装

1. 克隆仓库

git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server

1. 创建并激活虚拟环境

uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

1. 安装依赖

uv pip install -e .

1. 创建 .env 文件并添加 API 密钥

CFB_API_KEY=your_api_key_here

调试方式

1. 启动服务器

uv run cfbd-mcp-server

1. 连接到 Claude Desktop
2. 打开 Claude Desktop 配置文件
3. 添加服务器配置

4. 关闭并重新启动 Claude Desktop

5. 更新安装

cd cfbd-mcp-server
git pull
uv pip uninstall cfbd-mcp-server
# 删除构建工件和元数据
uv pip install -e .
uv sync --dev --all-extras
uv run cfbd-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。