TaskManager MCP Server 使用说明

项目简介

TaskManager MCP Server 是一个基于 Model Context Protocol (MCP) 构建的任务管理服务器。它旨在为 LLM 客户端（如 Claude Desktop）提供任务管理能力。通过 TaskManager，用户可以使用 LLM 客户端来规划、执行和跟踪任务，实现更高效的工作流程。

主要功能点

任务规划：接受用户输入的任务列表，将任务存储为队列，并生成任务执行计划。
任务执行：按顺序从队列中取出任务，供 LLM 客户端执行，并支持任务完成反馈。
任务状态跟踪：提供任务完成状态监控，允许用户跟踪任务进度。
任务管理操作：支持添加、更新和删除任务，灵活管理任务队列。
持久化存储：将任务数据存储在本地 JSON 文件中，支持数据持久化。
用户友好的提示信息：在任务执行的各个阶段提供清晰的状态提示和操作指导。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js 18 或更高版本。你可以通过 Node.js 官网下载安装包，或使用包管理器如 'brew install node' (macOS)。

克隆仓库: 使用 Git 克隆 TaskManager 仓库到本地：

git clone https://github.com/kazuph/mcp-taskmanager.git
cd mcp-taskmanager

安装依赖: 在仓库目录下，运行 npm 安装项目依赖：
```
npm install
```
构建项目: 运行 npm 构建项目，生成可执行文件：
```
npm run build
```

服务器配置

TaskManager MCP Server 需要配置到 MCP 客户端中才能使用。以 Claude Desktop 为例，你需要修改 Claude Desktop 的配置文件 'claude_desktop_config.json'。

打开 Claude Desktop 配置文件: 配置文件通常位于 '~/Library/Application Support/Claude/claude_desktop_config.json'。你可以通过 Claude Desktop 的开发者设置找到该文件。
添加工具配置: 在 'claude_desktop_config.json' 文件的 'tools' 字段中添加 'taskmanager' 工具的配置。配置信息如下：

{
  "tools": {
    "taskmanager": {
      "command": "npx",  // 启动命令，使用 npx 运行 npm 包
      "args": ["-y", "@kazuph/mcp-taskmanager"] // 命令参数，-y 表示自动安装 @kazuph/mcp-taskmanager 包
    }
  }
}

或者，如果你是开发者，并希望在本地开发模式下运行服务器，可以使用以下配置：

{
  "tools": {
    "taskmanager": {
      "command": "tsx", // 启动命令，使用 tsx 直接运行 TypeScript 文件 (需要全局安装 tsx: npm install -g tsx)
      "args": ["/path/to/mcp-taskmanager/index.ts"] // 命令参数，指向本地仓库的 index.ts 文件，请替换为你的实际路径
    }
  }
}

注意:

'/path/to/mcp-taskmanager/index.ts' 需要替换为你的 'mcp-taskmanager' 仓库在本地的实际路径。
使用 'tsx' 方式需要先全局安装 'tsx': 'npm install -g tsx' 或 'pnpm add -g tsx'。
'npx' 方式更适合普通用户，它会自动下载并运行 '@kazuph/mcp-taskmanager' npm 包，无需手动构建和指定路径。

基本使用方法

启动 Claude Desktop: 确保 Claude Desktop 客户端已启动并运行。
在 Claude Desktop 中与 TaskManager 交互: 你可以通过在 Claude Desktop 中输入指令来调用 TaskManager 的功能。例如：
- 规划任务: 告诉 Claude Desktop 你要规划一些任务，并提供任务列表。TaskManager 会返回任务执行计划。
```
请帮我规划以下任务：[ "任务一", "任务二", "任务三" ]
```
- 执行任务: 让 Claude Desktop 执行下一个任务。TaskManager 会返回队列中的下一个任务。
```
请执行下一个任务
```
- 标记任务完成: 当一个任务完成后，告诉 Claude Desktop 标记任务为已完成。
```
任务 "任务一" 已完成
```
- 获取任务列表: 查询当前的任务列表和状态。
```
请列出当前的任务列表
```
详细操作流程和指令，请参考仓库 README.md 文件中的 "Example Usage" 和 "Available Operations" 部分。

TaskManager MCP Server 通过 JSON-RPC 协议与 Claude Desktop 通信，并使用标准输入/输出 (stdio) 作为传输通道。你可以通过 Claude Desktop 与 TaskManager 进行交互，管理你的任务。

关键词