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