Ultimate Team MCP Server

🚀 最終ウルティメイトフrisbeeチーム MCP サーバー

このサーバーは、ウルティメイトフリスビーチームを管理するためのMCP（MCP）サーバーです。FastMCPを採用し、性能と可用性を向上させています。このサーバーは、プレイヤー管理、チャンピオンシップ管理、および関連機能をサポートしています。

✨ 主な機能

• プレイヤー管理：名前、連絡先などの情報を管理します。
• チャンピオンシップ管理：名前、開催場所、日付、コートタイプ、申し込み締め切り日などの情報を管理します。
• 登録と支払い追跡：プレイヤーのチャンピオンシップへの登録状況と支払い状況を記録します。
• 連盟支払い記録：支払い金額と支払い履歴を保存します。

📦 インストール

仮想環境の作成と依存関係のインストール

python -m venv venv
source venv/bin/activate  # 对于 macOS 和 Linux
venv\Scripts\activate  # 对于 Windows
pip install -r requirements.txt

環境変数の設定

.env-template を参考に .env ファイルを作成してください。

データベース接続の設定

• SQLiteCloud 形式：SQLITE_URI=sqlitecloud://hostname:port/database?apikey=your_api_key
• ローカル SQLite 形式：SQLITE_URI=file:///path/to/database.db

環境変数が設定されていない場合、デフォルトでローカル SQLite データベースのパスは ~/.ultimate.db となります。

テストの実行

pytest tests/

💻 使用例

コマンドラインインターフェイス（CLI）

MCP サーバーの起動

ultimate-team-mcp-server

使用例

• データベース URI の指定

  SQLITE_URI="sqlitecloud://host:port/database?apikey=key" ultimate-team-mcp-server
  

  またはコマンドラインオプションを使用して：

  ultimate-team-mcp-server --db-uri "sqlitecloud://host:port/database?apikey=key"
  

コマンド一覧

• ultimate-team-mcp-server help：利用可能なすべてのコマンドを表示します。
• import-csv：CSV ファイルをインポートします（旧バージョン）。
• import-players：プレイヤー情報をインポートして更新します。
• その他のコマンドについてはドキュメントを参照してください。

Claude Desktop との統合

claude_desktop_config.json に MCP サーバーの設定を追加します：

{
    "mcpServers": {
        "ultimate_mcp_server": {
            "command": "ultimate-team-mcp-server",
            "environment": {
                "SQLITE_URI": "sqlitecloud://host:port/database?apikey=key"
            }
        }
    }
}

Claude Code との統合

1. MCP サーバーを起動します。
2. Claude Code をインストールします。
3. MCP サーバーを追加します：

   claude mcp add ultimate -- ultimate-team-mcp-server
   

4. Claude を起動して使用します。

📚 ドキュメント

データベース構造

データベースのテーブルには以下が含まれます：

• プレイヤー：名前、連絡先。
• チャンピオンシップ：名前、開催場所、日付、コートタイプ、申し込み締め切り日。
• 登録記録：プレイヤーのチャンピオンシップへの参加状況と支払い状況。
• 連盟支払い：金額と支払い履歴。

詳細なスキーマ定義は src/ultimate_mcp_server/modules/init_db.py ファイルに記載されています。

CSV インポート形式

CSV ファイルの形式は以下の通りです：

Nombre,Telefono,Email
John Smith,+1234567890,john@example.com
Jane Doe,+0987654321,jane@example.com

フィールド名は大文字小文字を区別せず、英語と中国語（Nombre/Name、Telefono/Phone、Email）をサポートしています。

インポートコマンドの違い

• import-csv：旧バージョンのインポートツールで、新しいプレイヤーを追加しますが、重複は処理しません。
• import-players：新しいバージョンのインポートツールで、既存のプレイヤー情報を追加および更新します。