关键词

AI编程助手上下文持久化任务管理AI记忆项目编排

项目简介

MCP任务编排器是一个基于Kotlin实现的Model Context Protocol (MCP) 服务器，专为AI编码助手设计。它通过提供结构化、持久化的项目上下文，帮助AI助手在不同会话间保持记忆，从而解决AI在开发过程中上下文丢失的问题。它能管理项目、特性、任务、依赖和文档模板，并支持多种AI工作流。

主要功能点

  • 持久化AI记忆: 让AI助手在重启后也能记住项目状态、已完成工作和下一步计划。
  • 分层任务管理: 支持项目、特性、任务的层级组织，可定义任务间的依赖关系。
  • 丰富的AI工具集: 提供38个MCP工具，覆盖任务、特性、项目、依赖和文档管理等核心操作，允许AI调用外部功能。
  • 模板驱动的文档: 内置9种文档模板，如技术方案、需求、测试策略等，支持AI自动发现和应用，确保文档一致性。
  • AI工作流自动化: 预设6种工作流提示，用于AI初始化、特性创建、任务分解等常见开发场景。
  • RAG支持: 为AI提供结构化的知识检索，按需获取项目上下文和模板库，增强AI的生成能力。
  • 高效上下文管理: 采用渐进式加载和令牌优化技术，有效管理AI上下文窗口，节省令牌消耗。

安装步骤

1. 拉取Docker镜像

首先，从GitHub容器注册表拉取MCP任务编排器的最新Docker镜像：

docker pull ghcr.io/jpicklyk/task-orchestrator:latest

2. 配置您的AI代理

接下来，您需要配置您的AI助手（MCP客户端）以连接到MCP任务编排器服务器。

  • 对于 Claude Desktop，在您的 'claude_desktop_config.json' 文件中添加以下JSON片段：

    {
  "mcpServers": {
    "task-orchestrator": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--volume", "mcp-task-data:/app/data",
        "ghcr.io/jpicklyk/task-orchestrator:latest"
      ]
    }
  }
}

  • 对于 Claude Code，在命令行运行以下命令：

    claude mcp add-json task-orchestrator '{"type":"stdio","command":"docker","args":["run","--rm","-i","-v","mcp-task-data:/app/data","ghcr.io/jpicklyk/task-orchestrator:latest"]}'

  • 对于其他MCP兼容的AI代理 (如Cursor, Windsurf等)，请参考其官方文档，使用类似的Docker配置方式。关键是提供启动Docker容器的命令和参数。

3. 重启AI代理

完成配置后，请重启您的AI助手，使其加载新的MCP服务器配置。

服务器配置（AI客户端连接说明）

此处解释的是AI客户端如何配置以连接MCP任务编排器服务器，而非服务器本身的配置文件。

  • 连接方式: MCP任务编排器作为一个Docker容器运行，并通过标准输入/输出（Stdio）协议与您的AI客户端进行通信。
  • 服务器名称 (server name): 这是您在AI客户端中为MCP服务器定义的唯一标识符，例如 'task-orchestrator'。
  • 启动命令 (command): 告诉AI客户端如何启动MCP任务编排器进程。在这里，它是 'docker' 命令，用于启动Docker容器。
  • 命令参数 (args): 传递给启动命令的参数列表，用于指示Docker如何运行MCP任务编排器容器。这包括：
    • 'run': 运行一个新容器。
    • '--rm': 容器停止后自动删除，保持环境整洁。
    • '-i': 保持标准输入流打开，允许AI客户端与服务器通过标准输入/输出进行交互。
    • '--volume mcp-task-data:/app/data' 或 '-v mcp-task-data:/app/data': 这是一个关键参数，用于将名为 'mcp-task-data' 的Docker卷（一个持久化的存储区域）挂载到容器内部的 '/app/data' 目录。这意味着您的任务数据将持久化存储在Docker卷中，即使容器被删除或重新创建，数据也不会丢失。
    • 'ghcr.io/jpicklyk/task-orchestrator:latest': 指定要运行的MCP任务编排器的Docker镜像及其版本。
  • 传输类型 (type - 仅限Claude Code): 'stdio' (标准输入/输出协议)，是MCP支持的一种通信方式。

基本使用方法

配置完成后，您可以直接向AI助手提问，它将能够自动利用MCP任务编排器提供的持久化记忆和任务管理能力：

  • "为我的Web应用创建一个新项目"
  • "给我展示项目概览"
  • "将技术方案模板应用于这个任务"
  • "我完成了这个特性，请更新状态"

AI助手将自动与任务编排器交互，管理您的项目上下文，并记住会话间的进度和细节。

信息

分类

开发者工具

访问项目