星战科技xingzhan.cloud
返回市场
MCP任务组织者

MCP任务组织者

作者：rohanpatriot11 星标更新：2025-08-05
安装使用来源：spider==github.com

项目介绍

MCP任务组织器

smithery徽章 在MseeP上验证 <a href="https://glama.ai/mcp/servers/@rohanpatriot/mcp-tasks-organizer"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=779176367,2444965713&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

这是一个MCP服务器，它将Cursor代理计划转换成结构化的Markdown任务列表，并在你的仓库中进行组织。此服务器帮助你跟踪由AI生成的计划和建议作为可执行规范。

特性

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

安装

通过Smithery安装

要通过Smithery自动安装Tasks Organizer for Claude Desktop：

npx -y @smithery/cli install @huntsyea/mcp-tasks-organizer --client claude

先决条件

  • 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

手动安装

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

# 创建并激活虚拟环境（可选但推荐）
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# 安装依赖项
pip install -r requirements.txt

# 安装包
pip install -e .

与Claude for Desktop一起使用

  1. 从claude.ai/download安装Claude for Desktop

  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 for Desktop

  4. 通过询问Claude关于你的cursor计划来使用服务器，例如：

    • “将这个cursor计划转换成名为'Refactor Authentication'的任务列表，描述为'auth-refactor'：[粘贴计划]”
    • “从这个cursor代理输出创建一个标题为'Database Migration'的markdown任务列表，描述为'db-migration'：[粘贴输出]”
    • “将auth-refactor任务列表中的第2个任务标记为完成”
    • “列出我仓库中的所有任务文件”

提供的工具

该服务器提供以下工具：

1. create_task_list

创建一个新的任务列表并将其保存到.tasks文件夹中。

参数：

  • title：任务列表的标题
  • description：用于文件名的2-3个字的简短描述（例如，“refactor-authentication”）
  • repo_path：仓库根目录的路径（默认为当前目录）
  • include_metadata：是否包含创建日期/时间

2. convert_plan_to_tasks

将Cursor代理的计划文本转换成格式化的Markdown任务列表并保存。

参数：

  • plan_text：来自Cursor代理的计划文本
  • title：任务列表的标题
  • description：用于文件名的2-3个字的简短描述（例如，“refactor-authentication”）
  • repo_path：仓库根目录的路径（默认为当前目录）
  • include_metadata：是否包含如日期和时间的元数据

3. add_task

向现有的任务列表中添加新任务。

参数：

  • description：任务列表文件的描述标识符
  • task_text：新任务的文本
  • repo_path：仓库根目录的路径（默认为当前目录）
  • section：要添加任务的部分（默认为“Tasks”）

4. mark_task_complete

标记特定任务为已完成。

参数：

  • description：任务列表文件的描述标识符
  • task_number：要标记为完成的任务编号
  • repo_path：仓库根目录的路径（默认为当前目录）
  • section：任务所在的部分（默认为“Tasks”）

5. check_all_tasks_complete

检查所有任务是否完成，并通过重命名加上✅前缀来标记任务列表为已完成。

参数：

  • description：任务列表文件的描述标识符
  • repo_path：仓库根目录的路径（默认为当前目录）

6. list_task_files

列出.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-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

许可证

MIT