MCP 任务管理器

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

特征

• 自动从 Cursor 代理计划中提取任务

• 在您的存储库中创建一个.tasks文件夹，用于组织任务管理

• 使用描述性文件名（例如“refactor-authentication.md”）以便于识别

• 自动用✅前缀标记已完成的任务列表

• 使用适当的 Markdown 结构格式化计划

• 将内容组织为概述、实施细节和后续步骤

• 与 Claude for Desktop 和其他 MCP 客户端集成

Related MCP server: Task Manager MCP Server

安装

先决条件

• Python 3.10 或更高版本

• pip 或其他 Python 包管理器

快速安装

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

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Run the installation script
./install.sh

对于 Windows：

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Run the installation script
install.bat

手动安装

# Clone the repository
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# Create and activate a virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install the package
pip install -e .

与 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

执照

麻省理工学院