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：新版导入工具，新增和更新现有玩家信息。