大学橄榄球数据 MCP 服务器

MCP 服务器实现提供对来自Claude Desktop内的大学橄榄球数据 API的大学橄榄球统计数据的访问。

概述

该模型上下文协议 (MCP) 服务器使 AI 助手和应用程序能够：

查询全面的大学橄榄球统计数据和数据
访问比赛结果、球队记录和球员统计数据
分析比赛实况数据并进行总结
查看排名和获胜概率指标
比较团队表现并产生见解

用户可以使用自然语言运行查询。

示例输出

问：2014 赛季 FCS 比赛中最大的冷门是什么？

答：让我来帮您找出 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球队中得分最高的球队之一，其历史意义重大
事实上，这件事发生在恶劣的道路上

先决条件

Python 3.11 或更高版本
UV 包管理器（推荐）
大学橄榄球数据 API 密钥（在此获取）

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装大学橄榄球数据服务器：

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
添加服务器配置：

{
    "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

贡献

分叉存储库
创建功能分支
提交你的更改
推送到你的 fork
提交拉取请求

故障排除

常见问题

API 密钥错误
- 验证.env和claude_desktop_config.json文件中的 API 密钥是否设置正确
- 检查 collegefootballdata.com 上的密钥是否有效
速率限制
- 尽可能分散请求
- 考虑订阅 Patreon 以获得更高的限额
- 对频繁访问的数据实施缓存
连接问题
- 验证互联网连接
- 在 collegefootballdata.com 检查 API 状态
- 确保代码中正确处理错误

获取帮助

在 GitHub 上打开一个问题
查看API 文档
查看大学橄榄球数据 Discord

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

致谢

大学橄榄球数据提供 API
MCP 规范的模型上下文协议

cfbd-mcp-server

Integrations