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
   

💻 使用示例

工具列表

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

基础用法

以下是一个示例工作流程，展示如何使用 MCP 任务组织器：

# 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 许可证。