Ultimate Team MCP Server

🚀 最終極限飛盤隊 MCP 服務器

這是一個用於管理終極極限飛盤隊的 MCP（MCP）服務器，藉助 FastMCP 提升了性能和可用性。該服務器可實現玩家管理、錦標賽管理等相關功能，為飛盤隊的管理提供了便利。

🚀 快速開始

環境配置

創建虛擬環境並安裝依賴

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

配置環境變量

創建一個 .env 文件，參考提供的 .env-template。

設置數據庫連接

• SQLiteCloud 格式：SQLITE_URI=sqlitecloud://hostname:port/database?apikey=your_api_key
• 本地 SQLite 格式：SQLITE_URI=file:///path/to/database.db

如果沒有設置環境變量，默認使用本地 SQLite 數據庫路徑為 ~/.ultimate.db。

運行測試

pytest tests/

啟動 MCP 服務器

ultimate-team-mcp-server

✨ 主要特性

• 玩家管理：可管理玩家的名稱、聯繫方式等信息。
• 錦標賽管理：能管理錦標賽的名稱、地點、日期、場地類型、報名截止日期等信息。
• 註冊與支付跟蹤：記錄玩家參加錦標賽的註冊狀態及支付情況。
• 聯邦支付記錄：保存支付金額和支付歷史。

📦 安裝指南

環境配置

創建虛擬環境並安裝依賴

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

配置環境變量

創建一個 .env 文件，參考提供的 .env-template。

設置數據庫連接

• 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 並使用。

📚 詳細文檔

數據庫結構

數據庫表包括：

• 玩家：姓名、聯繫方式。
• 錦標賽：名稱、地點、日期、場地類型、報名截止日期。
• 註冊記錄：玩家參加錦標賽的狀態及支付情況。
• 聯邦支付：金額和支付歷史。

詳細 schema 定義在 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：新版導入工具，新增和更新現有玩家信息。