🚀 Claude Todo MCP Server
为Cursor、Windsurf和其他IDE中的任何AI编码助手添加持久化任务管理功能。 该MCP服务器复制了Claude Code的待办事项系统，使你的AI助手能够：
- 跨会话跟踪复杂的多步骤任务
- 将大型功能分解为可管理的部分
- 在你切换项目时记住进度
- 强制一次只专注于一个正在进行的任务
🔍 为什么需要它
没有任务管理功能时，AI助手会出现以下问题：
- ❌ 在对话之间忘记正在处理的任务
- ❌ 无法跟踪多步骤的实现过程
- ❌ 无法对复杂工作进行优先级排序或组织
- ❌ 在你切换上下文时让任务处于未完成状态
而使用这个MCP服务器，你将获得：
- ✅ 持久化记忆 - 任务在会话之间保持存在
- ✅ 项目范围管理 - 每个工作区都有自己的待办事项列表
- ✅ 自动跟踪 - AI知道何时创建/更新任务
- ✅ 进度可见性 - 确切了解哪些任务已完成/待处理
- ✅ 专注强制 - 一次只允许一个任务处于进行中状态
🚀 快速开始
无需安装！ 只需将以下内容添加到你的MCP配置中：
{
"mcpServers": {
"task-manager": {
"command": "uvx",
"args": ["claude-todo-emulator"]
}
}
}
- Cursor：在项目根目录下创建
.cursor/mcp.json文件。 - 其他IDE：将上述内容添加到你的MCP配置文件中。
重启你的IDE，然后尝试输入："为添加用户认证功能创建一个待办事项列表"。系统会在首次使用时自动下载包并完成所有设置！
💻 使用示例
基础用法
配置完成后，你的AI助手将自动执行以下操作：
创建复杂任务的待办事项
你: "添加支持用户偏好设置的黑暗模式"
AI: "我将为这个多步骤功能创建一个待办事项列表：
- ✅ 添加主题上下文和状态管理
- 🔄 创建黑暗模式的CSS变量和样式
- ⏳ 构建用于主题切换的设置界面
- ⏳ 为localStorage添加持久化功能
- ⏳ 更新现有组件以支持主题切换"
直观跟踪进度
你: "用户认证系统的进度如何？"
AI: "当前的用户认证任务：
- ✅ 设置JWT中间件
- ✅ 创建登录/注册端点
- 🔄 构建用户资料管理功能（进行中）
- ⏳ 添加密码重置流程
- ⏳ 实现基于角色的权限管理"
保持专注
你: "我们也来添加邮件通知功能吧"
AI: "我会将其添加到待办事项列表中，但我会先完成当前的用户资料任务以保持专注。"
📚 详细文档
API文档
TodoRead
- 参数：无
- 返回值：
{todos: Todo[]}
TodoWrite
- 参数：
{todos: Todo[]} - 返回值：
{success: boolean, count: number}
Todo 数据结构
{
id: string;
content: string;
status: "pending" | "in_progress" | "completed";
priority: "high" | "medium" | "low";
created_at: string;
updated_at: string;
metadata?: object;
}
🤝 贡献代码
- 分叉仓库
- 创建功能分支
- 为新功能添加测试
- 提交拉取请求
📄 许可证
本项目采用MIT许可证，详情请参阅 LICENSE 文件。