FastMCP Todo List Server

FastMCP Todo List Server

一款功能强大、特性丰富的待办事项列表服务，基于 FastMCP 构建，提供一套全面的待办事项管理工具。此服务可与 Claude Desktop 搭配使用，帮助你高效地创建、管理和整理任务。

功能特性

• 丰富的待办事项管理：使用丰富的元数据创建、读取、更新和删除待办事项
• 高级筛选与排序：按状态、优先级、标签、截止日期等条件筛选
• 搜索功能：按标题和描述搜索待办事项
• 自动备份：在任何数据变更前自动备份
• 手动备份：按需创建手动备份
• 统计信息：获取待办事项的详细统计信息
• 数据验证：全面验证所有输入
• 缓存：通过高效缓存减少文件 I/O
• 可配置：通过环境变量配置文件路径

安装

1. 克隆此仓库：

   git clone https://github.com/DustyPolk/todo_mcp.git
   cd todo_mcp
   

2. 创建并激活虚拟环境：

   python -m venv .venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

3. 安装所需的软件包：

   pip install fastmcp aiofiles
   

运行服务

使用以下命令运行服务：

python todolist_server.py

服务启动后，Claude Desktop 即可连接。

环境变量

你可以使用以下环境变量配置服务：

• TODO_FILE：存储待办事项的 JSON 文件路径（默认值：与脚本位于同一目录下的 todos.json）
• TODO_BACKUP_DIR：存储备份的目录路径（默认值：与脚本位于同一目录下的 backups）

可用工具

此服务提供以下工具：

add_todo

添加新的待办事项。

参数：

• title：待办事项的标题（必填，最多 100 个字符）
• description：详细描述（可选，最多 1000 个字符）
• due_date：截止日期，格式为 YYYY-MM-DD（可选）
• status：待办事项的状态（可选，可选值：pending、in_progress、done、cancelled）
• priority：优先级（可选，可选值：low、medium、high、critical）
• tags：用于分类的标签列表（可选）

list_todos

筛选、排序并分页列出待办事项。

参数：

• status：按状态筛选（可选，可选值：pending、in_progress、done、cancelled）
• priority：按优先级筛选（可选，可选值：low、medium、high、critical）
• search：在标题和描述中搜索（可选）
• tag：按标签筛选（可选）
• due_date_filter：按截止日期筛选（可选，可选值：overdue、today、upcoming、no_date）
• sort_by：排序字段（可选，默认值：id）
• sort_order：排序顺序（可选，可选值：asc、desc，默认值：asc）
• limit：最多返回的待办事项数量（可选，默认值：100）
• offset：跳过的待办事项数量（可选，默认值：0）

get_todo

按 ID 获取待办事项。

参数：

• todo_id：要获取的待办事项 ID

update_todo

按 ID 更新待办事项。

参数：

• todo_id：要更新的待办事项 ID
• title：新标题（可选）
• description：新描述（可选）
• due_date：新截止日期，格式为 YYYY-MM-DD（可选）
• status：新状态（可选，可选值：pending、in_progress、done、cancelled）
• priority：新优先级（可选，可选值：low、medium、high、critical）
• tags：新的标签列表（可选）

complete_todo

按 ID 将待办事项标记为已完成。

参数：

• todo_id：要标记为已完成的待办事项 ID

delete_todo

按 ID 删除待办事项。

参数：

• todo_id：要删除的待办事项 ID

batch_delete_todos

按 ID 批量删除待办事项。

参数：

• todo_ids：要删除的待办事项 ID 列表

create_backup

手动备份待办事项文件。

参数： 无

get_statistics

获取待办事项的统计信息。

参数： 无

数据结构

待办事项按以下结构存储：

{
  "id": 1,
  "title": "Complete project report",
  "description": "Finish the quarterly project report",
  "due_date": "2025-05-20",
  "status": "pending",
  "priority": "high",
  "tags": ["work", "quarterly"],
  "created_at": "2025-05-09T12:00:00.000000",
  "updated_at": "2025-05-09T12:00:00.000000"
}

许可证

MIT