返回 MCP 目录
public公开dns本地运行

mcp-taskmanager

一个基于MCP协议的任务管理服务器,为Claude Desktop等客户端提供队列式任务管理功能。

article

README

🚀 MCP 任务管理器

MCP 任务管理器借助模型上下文协议服务器实现任务管理功能,让 Claude Desktop(或其他 MCP 客户端)能基于队列系统管理和执行任务。

点击此处

🚀 快速开始(用户)

🔍 先决条件

  • Node.js 18+(可通过 brew install node 进行安装)
  • Claude Desktop(从 Claude Desktop 官网 下载安装)

⚙️ 配置

  1. 找到并打开你的 Claude Desktop 配置文件,其路径为: ~/Library/Application Support/Claude/claude_desktop_config.json

查找该文件的步骤如下: 1. 打开 Claude Desktop。 2. 点击菜单栏中的“Claude”。 3. 点击“设置”。 4. 点击“开发者”。

  1. 在配置文件中添加以下内容:
{
  "tools": {
    "taskmanager": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-taskmanager"]
    }
  }
}

✨ 主要特性

任务管理器支持两种主要的操作阶段:

📋 规划阶段

  • 接收用户提供的任务列表(字符串数组)。
  • 在内部将任务存储为队列。
  • 返回执行计划(包含任务概览、任务 ID、当前队列状态)。

▶️ 执行阶段

  • 应请求从队列中返回下一个任务。
  • 提供完成任务的反馈机制。
  • 从队列中移除已完成的任务。
  • 准备下一个任务以供执行。

📄 参数

| 参数 | 详情 | |------|------| | action | 可选值为 "plan"、"execute" 或 "complete" | | tasks | 任务字符串数组,在“plan”操作时为必需参数 | | taskId | 任务标识符,在“complete”操作时为必需参数 | | getNext | 布尔标志,用于在“execute”操作时请求下一个任务 |

💻 使用示例

基础用法

// 规划阶段
{
  action: "plan",
  tasks: ["任务 1", "任务 2", "任务 3"]
}

// 执行阶段
{
  action: "execute",
  getNext: true
}

// 完成任务
{
  action: "complete",
  taskId: "task-123"
}

🔧 开发人员相关

🔍 先决条件

  • Node.js 18+(可通过 brew install node 进行安装)
  • Claude Desktop(从 Claude Desktop 官网 下载安装)
  • tsx(通过 npm install -g tsx 安装)

📦 安装

git clone https://github.com/kazuph/mcp-taskmanager.git
cd mcp-taskmanager
npm install
npm run build

⚙️ 开发配置

  1. 确保 Claude Desktop 已安装并正在运行。
  2. 若尚未安装,全局安装 tsx:
npm install -g tsx
# 或者
pnpm add -g tsx
  1. 修改你的 Claude Desktop 配置文件,路径为: ~/Library/Application Support/Claude/claude_desktop_config.json

在 MCP 客户端配置中添加以下内容:

{
  "tools": {
    "taskmanager": {
      "args": ["tsx", "/path/to/mcp-taskmanager/index.ts"]
    }
  }
}
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端