MCP 任务管理器

一个 MCP 服务器，可将 Cursor 代理计划转换为结构化的 Markdown 任务列表，并将它们整理到您的代码库中。此服务器可帮助您跟踪 AI 生成的计划和建议，并将其作为可操作的规范。

特征

• 自动从 Cursor 代理计划中提取任务
• 在您的存储库中创建一个.tasks文件夹，用于组织任务管理
• 使用描述性文件名（例如“refactor-authentication.md”）以便于识别
• 自动用✅前缀标记已完成的任务列表
• 使用适当的 Markdown 结构格式化计划
• 将内容组织为概述、实施细节和后续步骤
• 与 Claude for Desktop 和其他 MCP 客户端集成

安装

先决条件

• Python 3.10 或更高版本
• pip 或其他 Python 包管理器

快速安装

对于基于 Unix 的系统（macOS、Linux）：

对于 Windows：

手动安装

与 Claude 桌面版一起使用

1. 从claude.ai/download安装 Claude 桌面版
2. 配置 Claude for Desktop 以使用此 MCP 服务器：打开~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或%APPDATA%\Claude\claude_desktop_config.json (Windows) 并添加：
   { "mcpServers": { "tasks-organizer": { "command": "python", "args": ["-m", "tasks_organizer"] } } }
3. 重启 Claude 桌面版
4. 通过向 Claude 询问您的游标计划来使用服务器，例如：
   • “将此游标计划转换为名为‘重构身份验证’的任务列表，描述为‘auth-refactor’：[粘贴计划]”
   • “从此游标代理输出创建一个 markdown 任务列表，标题为‘数据库迁移’，描述为‘db-migration’：[粘贴输出]”
   • “将 auth-refactor 任务列表中的任务 2 标记为已完成”
   • “列出我的存储库中的所有任务文件”

可用工具

服务器提供以下工具：

1. 创建任务列表

创建一个新的任务列表并将其保存到.tasks文件夹。

参数：

• title ：任务列表的标题
• description ：文件名的简短 2-3 个字描述（例如“refactor-authentication”）
• repo_path ：存储库根目录的路径（默认为当前目录）
• include_metadata ：是否包含创建日期/时间

2. 将计划转换为任务

将Cursor代理的计划文本转换为格式化的Markdown任务列表并保存。

参数：

• plan_text ：来自 Cursor 代理的计划文本
• title ：任务列表的标题
• description ：文件名的简短 2-3 个字描述（例如“refactor-authentication”）
• repo_path ：存储库根目录的路径（默认为当前目录）
• include_metadata ：是否包含日期和时间等元数据

3. 添加任务

将新任务添加到现有任务列表中。

参数：

• description ：任务列表文件的描述标识符
• task_text ：新任务的文本
• repo_path ：存储库根目录的路径（默认为当前目录）
• section ：将任务添加到哪个部分（默认为“任务”）

4. 标记任务完成

将特定任务标记为已完成。

参数：

• description ：任务列表文件的描述标识符
• task_number ：标记为完成的任务编号
• repo_path ：存储库根目录的路径（默认为当前目录）
• section ：任务位于哪个部分（默认为“任务”）

5. 检查所有任务是否完成

检查所有任务是否完成，并通过以✅前缀重命名将任务列表标记为已完成。

参数：

• description ：任务列表文件的描述标识符
• repo_path ：存储库根目录的路径（默认为当前目录）

6. 列出任务文件

列出 .tasks 目录中的所有任务文件。

参数：

• repo_path ：存储库根目录的路径（默认为当前目录）
• include_completed ：是否在输出中包含已完成的任务列表

工作原理

1. 服务器在你的存储库根目录中创建一个.tasks文件夹
2. 任务列表以基于 2-3 个单词描述的描述性文件名存储
3. 当列表中的所有任务都完成后，文件将以✅前缀重命名
4. 服务器解析来自 Cursor 代理的输入文本以提取任务
5. 它使用各种模式匹配技术提取任务：
   • 编号步骤（1. 第一步）
   • 要点（* 第一部分）
   • 包含“应该”、“必须”、“需要”等关键词的任务型句子
6. 如果没有找到明确的任务，它会将内容组织成逻辑部分
7. 随着任务的进展，可以跟踪和更新结果

示例工作流程

1. 代理人建议更改您的身份验证系统
2. 您将此计划转换为任务列表： convert_plan_to_tasks(plan_text, "Auth System Refactor", "auth-refactor")
3. 任务保存到.tasks/auth-refactor.md
4. 完成任务后，对其进行标记： mark_task_complete("auth-refactor", 1)
5. 当所有任务完成后： check_all_tasks_complete("auth-refactor")
6. 该文件重命名为.tasks/✅auth-refactor.md

执照

麻省理工学院