🚀 美国大学生橄榄球数据库接口（CFBD）模型上下文协议（MCP）服务器

本项目为美国大学生橄榄球数据库接口（CFBD）的模型上下文协议（MCP）服务器，提供了丰富的橄榄球数据资源、实用的工具功能和分析模板，帮助用户获取和分析相关数据。

🚀 快速开始

安装指南

克隆仓库

git clone git@github.com:username/repo.git
cd cfbd-mcp-server

安装依赖项

uv pip install -e ".[all]"

配置环境变量

1. 创建 .env 文件：

CFBD_API_KEY=your_api_key_here

2. 更新 claude_desktop_config.json 添加 MCP 工具配置。

启动服务器

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 - 分析历史对手对决情况

💻 使用示例

项目结构

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

🔧 技术细节

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

开发环境配置

1. 克隆仓库到本地
2. 安装开发依赖：

uv pip install -e ".[dev]"

3. 运行测试：

pytest tests/

📄 许可证

项目遵循 MIT 许可证，具体条款请参阅 LICENSE 文件。

💡 使用建议

欢迎贡献！请先阅读 CONTRIBUTING.md 了解如何参与开发。

此文档为 cfbd-mcp-server 的官方指南，旨在帮助用户快速上手和使用该工具。