使用说明

项目简介

College Football Data MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为支持 MCP 协议的 AI 助手（如 Claude Desktop）提供全面的大学美式橄榄球数据访问能力。通过此服务器，AI 助手可以查询比赛结果、球队记录、球员统计、排名等信息，并进行深入的数据分析。

主要功能点

资源 (Resources): 提供多种数据资源的 Schema 文档，包括比赛信息、球队记录、比赛队伍数据、比赛事件、比赛过程、球员数据统计、球队排名、赛前胜率预测、高级比赛统计等，方便客户端了解数据结构和字段含义。
工具 (Tools): 注册了多个工具，允许 AI 助手通过自然语言调用 College Football Data API 的各种接口，检索实时的大学美式橄榄球数据。例如，可以查询特定年份的比赛、特定球队的记录、特定比赛的详细数据等。
Prompt 模板 (Prompts): 预置了多种 Prompt 模板，支持 AI 助手进行更复杂的分析任务，例如分析单场比赛、分析单支球队赛季表现、分析赛季趋势、比较两支球队表现、分析历史对阵情况等。

安装步骤

克隆仓库:

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

创建并激活虚拟环境:

uv venv
source .venv/bin/activate   # macOS/Linux
.venv\Scripts\activate  # Windows

安装依赖:
```
uv pip install -e .
```
配置 API 密钥:
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加你的 College Football Data API 密钥。你可以在 College Football Data API 官网免费获取 API 密钥。
```
CFB_API_KEY=你的API密钥
```

服务器配置

为了让 MCP 客户端（如 Claude Desktop）连接到此 MCP 服务器，你需要配置客户端的 'claude_desktop_config.json' 文件。以下是针对 College Football Data MCP Server 的配置示例，你需要根据你的实际情况进行调整：

{
    "mcpServers": {
        "cfbd-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "<你的cfbd-mcp-server项目路径>",  // 将 '<你的cfbd-mcp-server项目路径>' 替换为你的本地仓库绝对路径，例如：/Users/username/cfbd-mcp-server
                "run",
                "cfbd-mcp-server"
            ],
            "env": {
                "CFB_API_KEY": "<你的API密钥>",    // 将 '<你的API密钥>' 替换为你在 .env 文件中配置的 API 密钥
                "PATH": "<你的Python路径>"      // 可选配置，如果 uv run cfbd-mcp-server 命令无法找到 Python，则需要指定 Python 解释器路径
            }
        }
    }
}

注意:

请将 '<你的cfbd-mcp-server项目路径>' 替换为你的本地 'cfbd-mcp-server' 仓库的实际绝对路径。
请将 '<你的API密钥>' 替换为你从 College Football Data API 官网获取的 API 密钥。
'<你的Python路径>' 为可选配置，通常在虚拟环境下可以省略，如果 Claude Desktop 无法找到 'uv' 或 'python' 命令，则需要手动指定 Python 解释器的路径。

基本使用方法

启动服务器: 在 'cfbd-mcp-server' 项目根目录下运行命令启动服务器：
```
uv run cfbd-mcp-server
```
服务器成功启动后，会在终端输出 "Server initialized and ready for connections" 信息。
连接 Claude Desktop:
- 按照上述 服务器配置 步骤配置 'claude_desktop_config.json' 文件。
- 关闭并重新启动 Claude Desktop 客户端。
- 如果配置成功，Claude Desktop 的输入框右下角会出现一个锤子图标，悬停时会显示可用的 MCP 工具数量。
在 Claude Desktop 中使用: 现在你可以直接在 Claude Desktop 中提出关于大学美式橄榄球的问题，例如：
- "2023年阿拉巴马大学的战绩如何？"
- "告诉我 2023 年第一周 SEC 赛区有哪些比赛？"
- "分析一下 2022 年总决赛的比赛。"
Claude Desktop 将会利用 College Football Data MCP Server 提供的工具和数据来回答你的问题。请注意，在提问时可以使用自然语言，无需了解具体的 API 参数。

关键词