🚀 美国大学生橄榄球数据库接口（CFBD）模型上下文协议（MCP）服务器
本项目提供了美国大学生橄榄球数据库接口（CFBD）的模型上下文协议（MCP）服务器，能帮助用户便捷地获取各类橄榄球相关数据，如比赛信息、球队记录等，并提供多种分析模板，助力用户深入分析赛事情况。
🚀 快速开始
按照以下步骤快速启动美国大学生橄榄球数据库接口（CFBD）模型上下文协议（MCP）服务器：
- 克隆仓库到本地。
- 安装依赖项。
- 配置环境变量。
- 启动服务器。
📦 安装指南
克隆仓库
git clone git@github.com:username/repo.git
cd cfbd-mcp-server
安装依赖项
uv pip install -e ".[all]"
配置环境变量
- 创建
.env文件：
CFBD_API_KEY=your_api_key_here
- 更新
claude_desktop_config.json添加 MCP 工具配置。
💻 使用示例
基础用法
项目结构
cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
└── cfbd_mcp_server/
├── .env
├── __init__.py
├── cfbd_schema.py
├── schema_helpers.py
└── server.py
启动服务器
uv run cfbd-mcp-server
✨ 主要特性
数据资源
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 限制
请求限制
- 免费层：每分钟有限的请求次数
- 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 tests/
📄 许可证
项目遵循 MIT 许可证，具体条款请参阅 LICENSE 文件。
贡献指南
欢迎贡献！请先阅读 CONTRIBUTING.md 了解如何参与开发。
此文档为 cfbd-mcp-server 的官方指南，旨在帮助用户快速上手和使用该工具。