Cfbd MCP Server

🚀 美國大學生橄欖球數據庫接口（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 的官方指南，旨在幫助用戶快速上手和使用該工具。