TaskWarrior MCP 服务器使用说明

项目简介

TaskWarrior MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 TaskWarrior 命令行任务管理工具的功能通过 MCP 协议暴露出来，使得支持 MCP 协议的客户端（如 Claude 桌面应用）可以通过自然语言调用 TaskWarrior 的功能，例如查看任务列表、添加新任务、标记任务完成等。

主要功能点

查看待办任务: 可以获取 TaskWarrior 中待处理的任务列表，并支持按项目和标签进行过滤。
添加新任务: 可以向 TaskWarrior 添加新的任务，并支持设置任务描述、截止日期、优先级、项目和标签。
标记任务完成: 可以将 TaskWarrior 中的任务标记为已完成。

安装步骤

安装 TaskWarrior: 确保您的系统上已经安装并配置了 TaskWarrior 命令行工具。您可以参考 TaskWarrior 官网获取安装指南。

安装 TaskWarrior MCP Server: 打开终端，运行以下命令全局安装 'mcp-server-taskwarrior'：

npm install -g mcp-server-taskwarrior

服务器配置

要将 TaskWarrior MCP Server 集成到 MCP 客户端（例如 Claude 桌面应用），您需要在客户端的配置文件中添加 MCP 服务器的配置信息。以 'claude_desktop_config.json' 为例，您需要添加如下配置：

{
  "mcpServers": {
    "taskwarrior": {  // 服务器名称，可以自定义
      "command": "npx", // 启动服务器的命令，这里使用 npx 执行 npm 包
      "args": [
        "-y",         // npx 参数，自动确认安装包
        "mcp-server-taskwarrior" // 要执行的 npm 包名称，即 TaskWarrior MCP Server
      ]
    }
  }
}

配置说明:

'"taskwarrior"': 是您为该 MCP 服务器自定义的名称，在客户端中用于标识和调用该服务器。您可以根据需要修改。
'"command": "npx"' 和 '"args": [...]': 指定了启动 TaskWarrior MCP Server 的命令。这里使用 'npx mcp-server-taskwarrior' 来运行全局安装的 'mcp-server-taskwarrior' 包。'-y' 参数是为了在使用 'npx' 运行包时，如果包未安装，自动确认安装。

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude）应该能够检测到并连接到 TaskWarrior MCP Server。您可以通过自然语言指令来指示客户端调用 TaskWarrior 的功能。

例如，在 Claude 中：

要查看当前的任务列表，您可以询问类似： "我的待办事项有哪些？" 或 "列出我未完成的任务。" Claude 可能会调用 'get_next_tasks' 工具并返回 TaskWarrior 的任务列表。
要添加一个新任务，您可以说： "添加一个任务，明天下午五点前完成，内容是给客户发邮件。" Claude 可能会调用 'add_task' 工具，并根据您的指令设置任务的描述和截止日期。
要标记一个任务为完成，您可以说： "我完成了第一个任务。" 或 "标记 ID 为 1 的任务为已完成。" Claude 可能会调用 'mark_task_done' 工具，并将指定的任务标记为完成。

请注意，具体的自然语言指令取决于 MCP 客户端的理解能力和 Prompt 设计。您可能需要参考 MCP 客户端的文档来了解如何更有效地使用 MCP 服务器的功能。

关键词