Tasks Organizer

🚀 MCP 任务组织器

MCP 任务组织器是一个 MCP 服务器，它能够将 Cursor 代理计划转换为结构化的 Markdown 任务列表，并将这些任务整理到您的仓库中。借助该服务器，您可以轻松跟踪 AI 生成的计划和建议，并将其转化为可操作的规范。

🚀 快速开始

MCP 任务组织器可以帮助您高效地管理任务。您只需按照安装步骤完成安装，即可使用它将 Cursor 代理计划转化为清晰的任务列表。

✨ 主要特性

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

📦 安装指南

先决条件

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

快速安装

基于 Unix 的系统（macOS、Linux）

# 克隆仓库
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# 运行安装脚本
./install.sh

Windows

# 克隆仓库
git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

# 运行安装脚本
.install.bat

手动安装

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-tasks-organizer.git
cd mcp-tasks-organizer

2. 创建并激活虚拟环境（可选但推荐）：
   • macOS/Linux：

python -m venv venv
source venv/bin/activate

- **Windows**：

python -m venv venv
.\venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 运行服务器：

python app.py

💻 使用示例

基础用法

本工具提供了一系列实用的命令，以下是这些命令的介绍：

• convert_plan_to_tasks：将计划文本转换为任务列表。
• mark_task_complete：标记任务列表中的某个任务为完成。
• check_all_tasks_complete：检查任务列表中所有任务是否完成。
• list_task_files：列出 .tasks 目录中的所有任务文件。

高级用法

以下是一个示例工作流程，展示了如何使用这些工具管理任务：

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。

🔧 技术细节

1. 服务器会在仓库根目录创建一个 .tasks 文件夹，用于存储任务列表。
2. 任务列表使用基于 2 - 3 个单词描述的文件名进行存储，方便识别。
3. 当任务列表中的所有任务完成时，文件会被重命名为带有 ✅ 前缀的新文件。
4. 服务器从 Cursor 的代理输入文本中解析任务，使用多种模式匹配技术提取任务，包括带编号的步骤（如“1. 第一步骤”）、列表项目（如“* 项目一”）以及类似于“应该”“必须”“需要”的句子。
5. 如果没有找到明确的任务，内容将被组织到逻辑部分中，以便于跟踪和更新任务进度。

📄 许可证

本项目采用 MIT 许可证。