College Football Data MCP Server

概述

这是一个 MCP (模型上下文协议) 服务器，允许 Claude 查询 College Football Data API 获取全面的大学橄榄球统计数据，支持游戏结果、球队记录、球员统计等自然语言查询。

先决条件

• Python 3.11+
• UV 包管理器 (推荐)
• College Football Data API 密钥
• Claude Desktop

安装选项

通过 Smithery 安装 (推荐)

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

手动安装

1. 克隆仓库并进入目录

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

2. 创建并激活虚拟环境

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

3. 安装依赖

   uv pip install -e .
   

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

   CFB_API_KEY=your_api_key_here
   

配置 Claude Desktop

1. 编辑 Claude Desktop 配置文件:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %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": "your_api_key_here",
                   "PATH": "/full/path/to/python"
               }
           }
       }
   }
   

3. 重启 Claude Desktop

安装成功后，您将在 Claude 界面右下角看到小锤子图标。

使用示例

尝试询问 Claude:

• "2014赛季FCS比赛中最大的冷门是什么？"
• "分析俄亥俄州立大学和密歇根大学之间的历史对决"
• "谁是2021年Heisman奖杯的获得者？"

更新服务器

cd cfbd-mcp-server
git pull
uv pip uninstall cfbd-mcp-server
rm -rf build dist *.egg-info  # Windows: rmdir /s /q build dist && del /s /q *.egg-info
uv pip install -e .
uv sync --dev --all-extras

重启 Claude Desktop 完成更新。

主要功能

数据类型

• 比赛信息和分数
• 球队记录和统计
• 逐场及驱动数据
• 球队排名
• 胜率预测
• 高级统计分析

分析模板

• 单场比赛详细分析
• 球队综合分析
• 赛季趋势分析
• 球队比较
• 历史对手分析

---

有了这个工具，您可以使用自然语言查询大学橄榄球数据，获得深入的统计分析和见解。