Divide and Conquer MCP Server

Divide and Conquer MCP 服务

一个模型上下文协议（MCP）服务，可让 AI Agent 使用结构化 JSON 格式将复杂任务拆分为易于管理的部分。

目录

• 用途
• 主要功能
• 快速开始
• 安装
• 工具
• 使用示例
• 使用场景
• 配置存储
• 贡献
• 许可证

用途

Divide and Conquer MCP 服务是 Temp Notes MCP 服务的演进版本，专为需要拆分为易于管理的部分的复杂任务而设计。该服务不再使用简单的文本文件，而是采用结构化 JSON 格式存储任务信息、清单和上下文，从而更便于跟踪进度，并在多次对话中保留上下文。

主要功能

• 结构化 JSON 格式：使用 JSON 结构存储任务信息，而非纯文本
• 任务跟踪：支持清单功能，并跟踪任务完成状态
• 上下文保留：提供专用字段来存储任务上下文和详细说明
• 进度监控：轻松查看已完成和剩余任务
• 任务排序：保留任务顺序，以便按顺序执行
• 插入任务：能够在清单中的特定位置插入新任务
• 元数据：跟踪标签、优先级和预计完成时间等附加信息
• 备注和资源：存储与任务相关的其他备注和资源

快速开始

1. 将服务添加到 MCP 配置中：

   {
     "mcpServers": {
       "divide-and-conquer": {
         "command": "npx",
         "args": ["-y", "@landicefu/divide-and-conquer-mcp-server"],
         "disabled": false
       }
     }
   }
   

2. 在对话中开始使用：

   // Initialize a new task
   await use_mcp_tool({
     server_name: "divide-and-conquer",
     tool_name: "initialize_task",
     arguments: {
       task_description: "Refactor the authentication system",
       context_for_all_tasks: "The current system uses session-based authentication."
     }
   });
   
   // Add checklist items
   await use_mcp_tool({
     server_name: "divide-and-conquer",
     tool_name: "add_checklist_item",
     arguments: {
       task: "Analyze current authentication flow",
       detailed_description: "Review the existing authentication code.",
       context_and_plan: "Look at src/auth/* files. The current implementation uses express-session with MongoDB store."
     }
   });
   

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Divide and Conquer 服务：

npx -y @smithery/cli install @landicefu/divide-and-conquer-mcp-server --client claude

选项 1：使用 npx（推荐）

将服务添加到 MCP 配置中：

{
  "mcpServers": {
    "divide-and-conquer": {
      "command": "npx",
      "args": ["-y", "@landicefu/divide-and-conquer-mcp-server"],
      "disabled": false
    }
  }
}

选项 2：从源代码安装

1. 克隆代码库：

   git clone https://github.com/landicefu/divide-and-conquer-mcp-server.git
   cd divide-and-conquer-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

4. 将服务添加到 MCP 配置中：

   {
     "mcpServers": {
       "divide-and-conquer": {
         "command": "node",
         "args": ["/path/to/divide-and-conquer-mcp-server/build/index.js"],
         "disabled": false
       }
     }
   }
   

工具

Divide and Conquer MCP 服务提供以下工具：

initialize_task

根据指定的描述和可选的初始清单项创建新任务。

update_task_description

更新主要任务描述。

update_context

更新所有任务的上下文信息。

add_checklist_item

向清单添加新项目。

update_checklist_item

更新现有清单项目。

mark_task_done

将清单项目标记为已完成。

mark_task_undone

将清单项目标记为未完成。

remove_checklist_item

从清单中移除项目。

reorder_checklist_item

将清单项目移动到新位置。

add_note

为任务添加备注。

add_resource

为任务添加资源。

update_metadata

更新任务元数据。

clear_task

清除当前任务数据。

get_checklist_summary

返回包含完成状态的清单摘要。为节省上下文窗口空间，摘要中会有意排除上下文信息。

get_current_task_details

获取当前任务（第一个未完成的任务）的详细信息及完整上下文，同时获取其他所有任务的有限字段。当前任务包含所有字段，包括 context_and_plan。其他任务仅包含 task、detailed_description 和完成状态（不包含 context_and_plan）。处理任务时，推荐使用此工具。

使用示例

初始化复杂任务

await use_mcp_tool({
  server_name: "divide-and-conquer",
  tool_name: "initialize_task",
  arguments: {
    task_description: "Refactor the authentication system to use JWT tokens and improve security",
    context_for_all_tasks: "The current system uses session-based authentication with cookies. We need to migrate to JWT for better scalability and security.",
    initial_checklist: [
      {
        task: "Analyze current authentication flow",
        detailed_description: "Review the existing authentication code to understand the current flow.",
        context_and_plan: "Look at src/auth/* files. The current implementation uses express-session with MongoDB store. Pay special attention to session expiration handling."
      },
      {
        task: "Design JWT implementation",
        detailed_description: "Create a design document outlining how JWT will be implemented.",
        context_and_plan: "Consider token structure, storage, and refresh mechanisms. Research best practices for JWT implementation in Node.js applications. Reference the security requirements document in docs/security.md."
      }
    ],
    metadata: {
      tags: ["security", "refactoring", "authentication"],
      priority: "high",
      estimated_completion_time: "2 weeks"
    }
  }
});

获取清单摘要

const summary = await use_mcp_tool({
  server_name: "divide-and-conquer",
  tool_name: "get_checklist_summary",
  arguments: {
    include_descriptions: true
  }
});

// Result contains a formatted summary of the checklist with completion status (context is excluded to save space)

获取当前任务详情

const taskDetails = await use_mcp_tool({
  server_name: "divide-and-conquer",
  tool_name: "get_current_task_details",
  arguments: {}
});

// Result contains:
// - ultimate_goal: The final goal of the entire task (task_description)
// - tasks: Array of all tasks, where the current task (first uncompleted) has all fields including context_and_plan,
//   while other tasks have limited fields (task, detailed_description, done) without context_and_plan
// - current_task_index: Index of the current task (first uncompleted)
// - Additional task metadata, notes, resources, etc.

使用场景

1. 复杂的软件开发任务

处理复杂的软件开发任务时，AI Agent 往往会遇到上下文窗口限制，难以在单次对话中完成所有步骤。Divide and Conquer MCP Server 支持 Agent：

• 将大型任务拆分成更小、更易管理的部分
• 在多次对话中跟踪进度
• 保留原本可能丢失的重要上下文
• 按逻辑顺序组织任务
• 记录决策和资源

2. 项目规划与管理

对于项目规划与管理任务，该服务支持：

• 创建包含任务和子任务的结构化项目计划
• 跟踪进度和完成状态
• 保留上下文和需求
• 记录决策和资源
• 在多次对话中协作

3. 研究与分析

开展研究与分析时，Agent 可以：

• 将研究问题拆分成需要调查的具体领域
• 跟踪进度和研究结果
• 保留上下文和背景信息
• 记录来源和资源
• 以结构化方式整理研究结果

JSON 结构

该服务使用以下 JSON 结构存储任务信息：

{
  "task_description": "A medium-level detailed description about the whole task. The final goal we want to achieve.",
  
  "checklist": [
    {
      "done": false,
      "task": "A short yet comprehensive name for the task",
      "detailed_description": "A longer description about what we want to achieve with this task",
      "context_and_plan": "Related information, files the agent should read, and more details from other tasks, as well as a detailed plan for this task. This is typically the longest string."
    }
  ],
  
  "context_for_all_tasks": "Information that all tasks in the checklist should include.",
  
  "metadata": {
    "created_at": "ISO timestamp",
    "updated_at": "ISO timestamp",
    "progress": {
      "completed": 0,
      "total": 1,
      "percentage": 0
    },
    "tags": ["tag1", "tag2"],
    "priority": "high|medium|low",
    "estimated_completion_time": "ISO timestamp or duration"
  },
  
  "notes": [
    {
      "timestamp": "ISO timestamp",
      "content": "Additional notes or observations about the overall task"
    }
  ],
  
  "resources": [
    {
      "name": "Resource name",
      "url": "URL or file path",
      "description": "Description of the resource"
    }
  ]
}

配置存储

默认情况下，Divide and Conquer MCP Server 将任务数据存储在以下位置：

• macOS/Linux：~/.mcp_config/divide_and_conquer.json（展开后为 /Users/username/.mcp_config/divide_and_conquer.json）
• Windows：C:\Users\username\.mcp_config\divide_and_conquer.json

首次初始化任务时会自动创建此文件。如果读取任务数据时文件不存在，服务将返回空任务结构，并在下次写入时创建该文件。

服务会处理以下情况：

• 读取时文件不存在：返回空任务结构
• 目录不存在：写入时自动创建目录结构
• 文件已损坏或无法访问：返回相应的错误消息

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。