项目简介

todo.ai是一个专为AI代理设计的任务管理系统，通过Model Context Protocol (MCP) 为AI助手提供持久化的任务跟踪能力。

主要功能

• 任务管理：创建、修改、完成、删除任务
• 子任务系统：支持层级化任务管理
• 笔记功能：为任务添加详细说明和进展记录
• 文件结构保留：智能维护TODO.md文件的原有格式和注释
• Git集成：任务列表作为Markdown文件存储在代码仓库中
• 标签分类：使用标签对任务进行组织和筛选
• 自动备份：提供版本回滚和数据恢复功能

安装步骤

使用uv安装（推荐）

uv tool install ai-todo

使用pipx安装

pipx install ai-todo

安装后提供两个命令：

• 'todo-ai'：命令行工具
• 'todo-ai-mcp'：MCP服务器

MCP服务器配置

在支持MCP的客户端（如Cursor、Claude Desktop）中配置：

• 服务器名称：'todo-ai'
• 启动命令：'todo-ai-mcp'
• 参数：无需额外参数，自动使用当前目录的TODO.md文件

基本使用

1. 在AI代理中启用MCP服务器
2. 使用自然语言管理任务，例如：
   • "创建用户认证功能的任务"
   • "将任务1标记为完成"
   • "显示所有带#bug标签的未完成任务

AI代理会自动将自然语言请求转换为相应的MCP工具调用，所有操作结果都会保存在项目的TODO.md文件中。