使用说明
项目简介
Task Master MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务端应用,它扩展了 Task Master CLI 的功能,使得 LLM 客户端(如 Cursor AI)能够通过标准化的 MCP 协议与 Task Master 进行交互,实现更智能化的 AI 驱动开发工作流。
主要功能点
-
任务管理工具集: 通过 MCP 协议暴露 Task Master CLI 的核心功能,包括:
- 列出任务 (listTasks): 允许 LLM 客户端查询和展示任务列表,支持按状态过滤和包含子任务。
- 查看任务详情 (showTask): 允许 LLM 客户端获取特定任务的详细信息,包括描述、状态、依赖等。
- 设置任务状态 (setTaskStatus): 允许 LLM 客户端更新任务的状态,例如标记为“完成”、“进行中”等。
- 扩展任务 (expandTask): 允许 LLM 客户端指示 Task Master 将复杂任务分解为更小的子任务。
- 获取下一个任务 (nextTask): 允许 LLM 客户端查询 Task Master 推荐的下一个待处理任务。
- 添加新任务 (addTask): 允许 LLM 客户端指示 Task Master 创建新的任务。
-
标准 MCP 协议支持: 实现了 FastMCP 框架,确保与 MCP 客户端的兼容性和互操作性。
-
与 Task Master CLI 集成: 无缝对接 Task Master CLI 的现有功能,通过工具的形式将 CLI 命令暴露给 MCP 客户端。
安装步骤
-
安装 Task Master CLI: 确保您已安装 Task Master CLI 工具。如果尚未安装,请参考仓库 https://github.com/eyaltoledano/claude-task-master 的安装说明进行安装。通常可以使用 npm 全局安装:
npm install -g task-master-ai -
安装 MCP Server (可选): MCP Server 代码已经包含在 Task Master CLI 包中,无需单独安装。
服务器配置
MCP 服务器主要通过 Task Master CLI 包提供,作为 MCP 客户端,您需要配置 MCP 服务器的启动命令,以便客户端能够连接并调用 Task Master 的功能。以下是在 MCP 客户端(例如 Cursor AI)中配置 Task Master MCP Server 的示例配置信息(JSON 格式):
{ "serverName": "Task Master", // MCP 服务器的名称,您可以自定义 "serverType": "Command", // 服务器类型设置为 "Command" 表示通过命令行启动 "command": "npx", // 启动命令,这里使用 npx "args": [ // 启动参数 "-y", // npx 参数,自动确认安装包 "--package", // npx 参数,指定要运行的包 "task-master-ai", // 要运行的 npm 包名称 "task-master-mcp" // 包中要执行的命令,即启动 MCP 服务器的命令 ] }
配置说明:
- '"serverName"': MCP 服务器的名称,用于在客户端界面中标识和管理服务器连接。
- '"serverType"': 指定服务器类型为 "Command",表示通过执行命令行命令来启动服务器。
- '"command"': 设置为 '"npx"',这是一个 Node.js 的包执行器,用于运行 npm 包。
- '"args"': 一个字符串数组,包含了传递给 'npx' 命令的参数:
- '"-y"': 'npx' 的参数,用于跳过安装包时的确认提示。
- '"--package"': 'npx' 的参数,用于指定要执行的 npm 包。
- '"task-master-ai"': 指定要执行的 npm 包是 'task-master-ai',即 Task Master CLI 工具包。
- '"task-master-mcp"': 指定在 'task-master-ai' 包中要执行的命令是 'task-master-mcp',这个命令实际是 'package.json' 中配置的,用于启动 MCP 服务器。
请注意: 您需要将以上 JSON 配置信息添加到您的 MCP 客户端(例如 Cursor AI)的服务器配置中。具体的配置步骤请参考您使用的 MCP 客户端的文档。
基本使用方法
配置完成后,您的 MCP 客户端(如 Cursor AI)应该能够连接到 Task Master MCP Server。您可以通过客户端提供的界面或命令,调用以下 Task Master 工具,实现任务管理功能:
- 使用 'listTasks' 工具列出所有任务或按状态筛选任务。
- 使用 'showTask' 工具查看特定任务的详细信息。
- 使用 'setTaskStatus' 工具更新任务的状态。
- 使用 'expandTask' 工具将复杂任务分解为子任务。
- 使用 'nextTask' 工具获取 Task Master 推荐的下一个任务。
- 使用 'addTask' 工具创建新的任务。
具体工具的使用方法和参数,请参考 MCP 客户端的工具调用说明。
信息
分类
开发者工具