🚀 最终极限飞盘队 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 集成
- 启动 MCP 服务器。
- 安装 Claude Code。
- 添加 MCP 服务器：
claude mcp add ultimate -- ultimate-team-mcp-server
- 运行 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：新版导入工具，新增和更新现有玩家信息。