Cfbd MCP Server

🚀 アメリカ大学生ラグビーデータベースインターフェース（CFBD）モデルコンテキストプロトコル（MCP）サーバー

このサーバーは、アメリカ大学生ラグビーのデータを提供するCFBD APIを利用した、モデルコンテキストプロトコル（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 ツールの設定を追加します。

💻 使用例

プロジェクト構造

cfbd-mcp-server/
├── README.md
├── pyproject.toml
└── src/
    └── cfbd_mcp_server/
        ├── .env
        ├── __init__.py
        ├── cfbd_schema.py
        ├── schema_helpers.py
        └── server.py

サーバーの起動

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 - 2つのチームの成績を比較
• analyze-rivalry - 歴史的な対戦相手の対決状況を分析

📚 ドキュメント

API 制限

リクエスト制限

• 無料プラン：1分間のリクエスト回数に制限があります。
• 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 の公式ガイドであり、ユーザーがこのツールをすぐに使い始めるのを助けることを目的としています。