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 桌面版一起使用

从claude.ai/download安装 Claude 桌面版
配置 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"] } } }
重启 Claude 桌面版
通过向 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 ：是否在输出中包含已完成的任务列表

工作原理

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

示例工作流程

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