Claude Todo Emulator

🚀 Claude Todo MCP Server

本项目为Cursor、Windsurf等各种IDE中的AI编码助手添加了持久化任务管理功能，能让AI像Claude Code一样高效管理多步骤任务，确保任务不遗忘、进度可追踪。

🚀 快速开始

无需安装！ 只需将以下内容添加到你的MCP配置中：

{
  "mcpServers": {
    "task-manager": {
      "command": "uvx",
      "args": ["claude-todo-emulator"]
    }
  }
}

• Cursor：在项目根目录下创建 .cursor/mcp.json 文件。
• 其他IDE：将上述内容添加到你的MCP配置文件中。

重启你的IDE，然后尝试： "Create a todo list for adding user authentication"

系统会在首次使用时自动下载并完成所有设置！

✨ 主要特性

无任务管理时AI助手的痛点

• ❌ 在对话之间忘记正在处理的任务。
• ❌ 无法跟踪多步骤实现的进度。
• ❌ 不能对复杂工作进行优先级排序或组织。
• ❌ 切换上下文时任务会半途而废。

使用本MCP服务器的优势

• ✅ 持久化内存：任务在会话间保持有效。
• ✅ 项目范围管理：每个工作区都有自己的待办事项列表。
• ✅ 自动跟踪：AI知道何时创建/更新任务。
• ✅ 进度可视化：清楚看到已完成和待完成的任务。
• ✅ 专注执行：同一时间只处理一个任务。

💻 使用示例

基础用法

为复杂任务创建待办事项

你: "Add dark mode support with user preferences"
AI: "我将为这个多步骤功能创建一个待办事项列表：
- ✅ 添加主题上下文和状态管理
- 🔄 创建暗模式CSS变量和样式
- ⏳ 构建主题切换设置界面
- ⏳ 将设置持久化到localStorage
- ⏳ 更新现有组件以支持主题"

可视化跟踪进度

你: "What's the status on the authentication system?"
AI: "当前认证系统任务：
- ✅ 设置JWT中间件
- ✅ 创建登录/注册端点
- 🔄 构建用户个人资料管理（进行中）
- ⏳ 添加密码重置流程
- ⏳ 实现基于角色的权限"

保持专注

你: "Let's also add email notifications"
AI: "我会将其添加到待办事项列表中，但让我先完成当前的用户个人资料任务以保持专注。"

📚 详细文档

API参考

TodoRead

• 参数：无
• 返回值：{todos: Todo[]}

TodoWrite

• 参数：{todos: Todo[]}
• 返回值：{success: boolean, count: number}

Todo Schema

{
  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 文件。

🔗 相关项目

• Model Context Protocol
• FastMCP
• Claude Code