关键词

AI项目管理智能规划LLM工具任务协调敏捷开发

项目简介

Plan Manager是一款专为AI代理和LLM设计的项目管理工具，通过提供结构化的计划、故事和任务管理功能，帮助AI在有限的上下文窗口内协调复杂的工作流。它允许用户或LLM创建、更新和删除计划、故事和任务，并管理它们的状态、依赖关系和审批流程。作为一个MCP服务器，Plan Manager能够以标准化的方式向LLM客户端提供上下文信息和可调用的功能（工具），以及预定义的交互模式（Prompt模板）。

主要功能点

  • 分层规划: 支持计划（Plan）、故事（Story）和任务（Task）的三层结构化项目管理。
  • 工作流管理: 提供TODO、IN_PROGRESS、PENDING_REVIEW、DONE、BLOCKED、DEFERRED等多种任务状态，并支持审批流程以控制任务进展。
  • 依赖管理: 允许定义任务和故事间的依赖关系，并自动检测和阻止循环依赖。
  • 上下文提供: 作为MCP服务器，向AI代理提供当前项目、故事、任务等全面的上下文信息。
  • 工具调用: 允许AI代理通过标准JSON-RPC协议调用内置工具（如创建计划、获取故事、更新任务）来执行项目管理操作。
  • Prompt模板: 提供预定义的Prompt模板，帮助AI代理理解和执行特定操作（如如何创建任务列表、如何生成任务步骤）。
  • 资源托管: 托管代理使用的文档（如使用指南、项目工作流图），作为MCP资源供AI代理查阅。
  • 变更日志: 可生成已完成任务的变更日志预览，方便记录项目进展。

安装步骤

  1. 安装'uv' (推荐): 如果您的系统尚未安装'uv'，建议先安装它以获得更快的包管理体验： 
    pip install uv
  2. 安装Plan Manager: 使用'uv'或'pip'工具安装Plan Manager包： 
    uv add plan-manager
# 或者如果通过 pip 安装：
pip install plan-manager

服务器配置

Plan Manager作为MCP服务器运行。MCP客户端（例如Cursor IDE）需要以下配置信息才能连接并与其交互。请将以下JSON结构添加到您的MCP客户端的配置文件中（例如，Cursor IDE的'.cursor/mcp.json'文件）。

{
  "mcpServers": {
    "plan-manager": {
      "url": "http://localhost:3000/mcp", // MCP服务器的通信地址，请确保与服务器实际启动地址一致。
      "command": "pm",                   // 启动Plan Manager服务器的命令，通常为安装后自动创建的“pm”别名。
      "args": []                         // 启动命令的额外参数列表，默认情况下可为空。
    }
  }
}

注意:

  • 'url': 默认情况下，服务器将在'http://localhost:3000/mcp'启动。如果您的MCP客户端与服务器在不同的Docker容器或主机上，您可能需要将'localhost'更改为'host.docker.internal'或实际的服务器IP地址。
  • 远程访问: 如果您需要从其他主机访问Plan Manager服务器，请在启动服务器时设置环境变量'HOST=0.0.0.0'，例如'HOST=0.0.0.0 pm'。这将使服务器监听所有网络接口。

基本使用方法

  1. 启动服务器: 在终端中运行以下命令启动Plan Manager服务器： 
    uv run pm
# 或者如果通过 pip 安装：
pm
    服务器启动后，将默认在'http://localhost:3000/mcp'监听MCP客户端的请求。
  2. 连接MCP客户端: 按照上述“服务器配置”部分，在您的MCP客户端（例如，Cursor IDE）中配置Plan Manager服务器。
  3. 与AI代理交互:
    • 在MCP客户端的聊天窗口中，输入'/'可以列出Plan Manager提供的所有Prompt模板，例如'/create_plan'、'/create_stories'、'/create_tasks'、'/create_steps'。
    • 通过使用这些Prompt模板，您可以指导AI代理创建和管理项目中的计划、故事和任务。AI代理将根据模板内容和您的指令，调用Plan Manager提供的后台工具。
    • 例如，您可以对AI代理说“请为我创建一个新的计划”，AI代理会使用'/create_plan' Prompt来生成计划草稿，并最终通过'create_plan'工具在Plan Manager中创建它。
    • 利用'/report'工具，您可以随时获取当前计划或故事的详细状态报告，帮助您和AI代理了解项目进展。
    • 使用'set_current_plan'、'set_current_story'、'set_current_task'工具，可以方便地切换AI代理当前关注的工作上下文。

信息

分类

AI与计算

访问项目