article
README
🚀 MCP 任务管理器
MCP 任务管理器借助模型上下文协议服务器实现任务管理功能,让 Claude Desktop(或其他 MCP 客户端)能基于队列系统管理和执行任务。
🚀 快速开始(用户)
🔍 先决条件
- Node.js 18+(可通过
brew install node进行安装) - Claude Desktop(从 Claude Desktop 官网 下载安装)
⚙️ 配置
- 找到并打开你的 Claude Desktop 配置文件,其路径为:
~/Library/Application Support/Claude/claude_desktop_config.json
查找该文件的步骤如下: 1. 打开 Claude Desktop。 2. 点击菜单栏中的“Claude”。 3. 点击“设置”。 4. 点击“开发者”。
- 在配置文件中添加以下内容:
{
"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
⚙️ 开发配置
- 确保 Claude Desktop 已安装并正在运行。
- 若尚未安装,全局安装 tsx:
npm install -g tsx
# 或者
pnpm add -g tsx
- 修改你的 Claude Desktop 配置文件,路径为:
~/Library/Application Support/Claude/claude_desktop_config.json
在 MCP 客户端配置中添加以下内容:
{
"tools": {
"taskmanager": {
"args": ["tsx", "/path/to/mcp-taskmanager/index.ts"]
}
}
}
微信扫一扫