AI导哈

大学橄榄球数据服务器

一个提供大学橄榄球统计数据访问的MCP服务器，支持查询比赛结果、球队记录、球员统计等，适用于体育数据分析场景。

  • by lenwood
  • Python
  • 本地部署
  • 27 星标
  • 更新于
在 GitHub 查看 lenwood/cfbd-mcp-server

使用说明

大学足球数据MCP服务器

MCP服务器实现，提供对来自 大学橄榄球数据API V2 在...之内 克劳德桌面.

概述

此模型上下文协议（MCP）服务器使AI助手和应用程序能够：

  • 查询高校足球综合统计数据
  • 访问比赛结果、球队记录和球员统计数据
  • 逐一分析播放数据和驱动器摘要
  • 查看排名和获胜概率指标
  • 比较团队绩效并产生见解

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

样本输出

问：2014赛季FCS比赛中最大的失利是什么？

A.让我来帮你找出2014年FCS最大的失误。我将查看比赛数据，重点关注FCS团队之间的比赛，在这些比赛中，团队实力存在显著差距，结果出乎意料。

数据显示，2014年FCS出现了几次明显的动荡，但最突出的是2014年9月6日华盛顿东部以52比59击败华盛顿。这一点尤其重要，因为：

  1. 华盛顿是Pac-12会议的FBS团队
  2. 比赛在华盛顿的主场（赫斯基体育场）进行
  3. 根据赛后统计，华盛顿东部的获胜概率仅为1.4%
  4. 华盛顿东区得到的59分是FCS队对阵Pac-12对手的最高得分
  5. 华盛顿在比赛中获得了多分的优势

该赛季其他值得注意的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
  1. 克隆此存储库：
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server
  1. 创建并激活虚拟环境：
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. 安装依赖项：
uv pip install -e .
  1. 创建一个 .env 文件，并添加您的API密钥：
CFB_API_KEY=your_api_key_here

手动安装

  1. 克隆此存储库：
git clone https://github.com/yourusername/cfbd-mcp-server
cd cfbd-mcp-server
  1. 创建并激活虚拟环境：
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. 安装依赖项：
uv pip install -e .
  1. 创建一个 .env 文件，并添加您的API密钥：
CFB_API_KEY=your_api_key_here

用法

运行服务器

启动服务器：

uv run cfbd-mcp-server

与Claude Desktop连接

  1. 在以下位置打开您的Claude Desktop配置：

    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  2. 添加服务器配置：

{
    "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"
            }
        }
    }
}
  1. 关闭然后重新启动Claude Desktop

重新启动后，您可以通过单击文本框左下角的加号来确认安装。如果成功，您将看到“从cfbd-mcp服务器添加”作为菜单选项之一。这是一个示例截图。

安装后更新

  1. 下载更新的文件
cd cfbd-mcp-server
git pull
  1. 卸载现有软件包：
uv pip uninstall cfbd-mcp-server
  1. 删除现有的构建工件和元数据

对于Windows：

rmdir /s /q build dist
del /s /q *.egg-info

对于macOS：

rm -rf build dist *.egg-info
  1. 安装修订后的包及其依赖项
uv pip install -e .
uv sync --dev --all-extras

uv run cfbd-mcp-server
  1. 关闭并重新启动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

为发展而设立

  1. 克隆存储库
  2. 安装开发依赖项：
uv pip install -e ".[dev]"
  1. 运行测试：
pytest

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 提交您的更改
  4. 推你的叉子
  5. 提交拉取请求

故障排除

常见问题

  1. API密钥错误

    • 验证API密钥在 .env 和 claude_desktop_config.json 文件
    • 在collegefootballdata.com上检查密钥是否有效

  2. 速率限制

    • 尽可能间隔出请求
    • 考虑订阅Patreon以获得更高的限制
    • 对频繁访问的数据实施缓存

  3. 连接问题

    • 验证互联网连接
    • 在collegefootball data.com上查看API状态
    • 确保在代码中正确处理错误

获取帮助

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

相关 MCP