College Football Data MCP Server

概述

大学橄榄球数据(CFBD) MCP服务器让您可以通过Claude桌面版使用自然语言查询大学橄榄球数据API的丰富统计数据。

前提条件

• Python 3.11+
• UV包管理器（推荐）
• CFBD API密钥

安装选项

选项1: 通过Smithery安装（推荐）

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

选项2: 手动安装

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桌面版

1. 打开Claude桌面版配置文件:

   • 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桌面版

安装成功时，您将在Claude文本框右下角看到一个小锤子图标。

使用示例

您可以直接用自然语言向Claude提问，例如:

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

Claude将查询API并分析数据，提供详细解答。

主要功能

• 查询比赛结果、球队记录和球员统计
• 分析逐场比赛数据和驱动摘要
• 查看排名和胜率指标
• 比较球队表现并生成洞察

更新服务器

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桌面版。

API限制说明

CFBD API免费使用但有速率限制。CFBD Patreon订阅者可获得更高的速率限制。