Ultimate Frisbee Team MCP Server
2025.04.05
0
Python团队管理比赛管理支付跟踪其它
Ultimate Frisbee Team MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于管理 Ultimate Frisbee 团队的球员、比赛和支付信息。该服务提供了球员管理、比赛管理、联盟支付跟踪等功能，支持通过 CLI 或 MCP 接口进行访问，并使用 SQLite 或 SQLiteCloud 作为数据库存储。
View on GitHub
Overview
基本能力
产品定位
Ultimate Frisbee Team MCP Server 是一个专门用于管理 Ultimate Frisbee 团队球员、比赛和支付信息的服务。
核心功能
- 球员管理
- 添加球员（包括姓名、电话号码和可选邮箱）
- 列出所有球员
- 移除球员
-
从 CSV 文件导入球员
-
比赛管理
- 创建比赛（包括名称、地点、日期、场地类型和注册截止日期）
- 列出、更新和移除比赛
- 注册/取消注册球员参加比赛
- 跟踪球员的比赛支付状态
-
通过模糊名称匹配搜索已支付球员
-
联盟支付跟踪
- 记录球员的联盟支付
- 跟踪支付金额和日期
- 列出球员的支付历史
-
移除最近的支付记录
-
系统功能
- 备份数据库到文件
- 支持 CLI 或 MCP 接口访问
- 使用 FastMCP 提升 AI 交互性能
适用场景
- Ultimate Frisbee 团队的日常管理
- 比赛组织和球员注册
- 支付和费用跟踪
工具列表
- CLI 工具：提供球员管理、比赛管理、支付跟踪等功能的命令行接口。
- CSV 导入工具：支持从 CSV 文件导入球员信息。
- 数据库备份工具：支持将数据库备份到指定文件。
常见问题解答
- 如何设置数据库连接？
- 创建
.env文件并设置SQLITE_URI或DB_URI环境变量。 -
支持 SQLiteCloud 或本地 SQLite 数据库。
-
CSV 导入的格式要求是什么？
-
CSV 文件应包含
Nombre/Name、Telefono/Phone和Email列。 -
如何更新已存在的球员信息？
- 使用
import-players命令可以更新已存在的球员信息。
使用教程
使用依赖
- 创建虚拟环境：
uv venv
- 激活虚拟环境：
source .venv/bin/activate
- 安装开发依赖：
uv pip install -e ".[dev]"
- 设置环境变量（可选）：
cp .env-template .env
# 编辑 .env 文件
- 运行测试：
pytest tests/
安装教程
- 安装包：
uv pip install -e ".[dev]"
- 启动服务：
ultimate-team-mcp-server
调试方式
- 列出所有球员：
ultimate-team-mcp-server list-players
- 列出所有比赛：
ultimate-team-mcp-server list-tournaments
- 备份数据库：
ultimate-team-mcp-server backup /path/to/backup.db