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 許可證。