Claude Todo Emulator

🚀 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;
}

🤝 贡献代码

1. 分叉仓库
2. 创建功能分支
3. 为新功能添加测试
4. 提交拉取请求

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。

🔗 相关项目

• 模型上下文协议
• FastMCP
• Claude Code