MCP任务战士AI桥
一个AI原生Taskwarrior桥，为Claude Code和其他AI系统提供自然语言任务管理。此MCP（模型上下文协议）服务器在现有Taskwarrior基础架构的基础上构建时，扩展了Taskwarrior的上下文感知自然语言功能。
特性
- 自然语言处理：将日常语言转换为Taskwarrior命令
- 项目上下文感知：自动检测当前项目/工单上下文
- 票务集成：从工单清单同步任务（支持.tices/目录结构）
- 艾森豪威尔矩阵：按紧迫性和重要性组织任务
- 智能任务添加：智能解析优先级、截止日期、项目和标签
- 可共享和版本化：可以在Git中跟踪配置
安装
先决条件
- 安装Taskwarrior（如果尚未安装）：
brew install task- 安装Node.js（v20或更高版本）：
brew install node设置
- 克隆存储库：
git clone https://github.com/storypixel/mcp-taskwarrior-ai.git
cd mcp-taskwarrior-ai- 安装依赖项：
npm install- 构建项目：
npm run build与Claude Code集成
将服务器添加到您的Claude Code MCP配置中：
- 打开您的克劳德代码设置
- 添加到MCP服务器：
{
"mcpServers": {
"taskwarrior": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-taskwarrior-ai/dist/index.js"],
"env": {}
}
}
}或者使用Claude CLI：
claude mcp add taskwarrior -s project -- node /path/to/mcp-taskwarrior-ai/dist/index.js用法
自然语言命令
该桥理解任务管理的自然语言：
- 添加任务：“添加修复登录错误”，“创建代码审查任务”，“todo实现缓存”
- 列出任务：“显示所有任务”、“我下一步应该做什么”、“列出紧急任务”、”显示今天的任务”
- 完成任务：“将任务5标记为已完成”，“完成任务1”，“结束复习任务”
- 上下文查询：“我在哪里”，“我目前的项目是什么”，“显示当前背景”
可用工具
task_natural
使用自然语言执行Taskwarrior命令。
{
query: "add fix the authentication bug with high priority"
}task_smart_add
添加具有结构化元数据的任务：
{
description: "Implement user authentication",
project: "myheb-android",
priority: "H",
due: "tomorrow",
tags: ["security", "auth"]
}task_ticket_sync
从工单清单中导入任务：
{
ticket: "DRX-12345"
}task_eisenhower
按照艾森豪威尔矩阵象限组织任务。
task_where_am_i
根据项目状态获取当前上下文和建议的下一步操作。
task_context_set
为所有任务操作设置当前项目/上下文：
{
context: "DRX-12345"
}task_raw
为高级用户执行原始Taskwarrior命令：
{
command: "modify 1 priority:H +urgent"
}项目上下文集成
网桥使用以下命令自动检测项目上下文：
.taskproject文件 -如果存在，则定义Taskwarrior的项目名称- Git存储库名称 -从git回退到repo名称
- 目录名称 -如果不在git中，则使用当前目录名
要覆盖项目检测，请创建 .taskproject 文件：
echo "my-project-name" > .taskproject当一个工作区管理另一个项目的任务时，这很有用。
该桥还检测到：
- 当前Git分支（用于票证上下文）
- 任务状态来自
.task-state.json - 工单任务来自
.tickets//mr-checklist.md
建筑
┌─────────────────┐
│ Claude Code │
│ or AI Agent │
└────────┬────────┘
│ Natural Language
▼
┌─────────────────┐
│ MCP Server │
│ - NLP Parser │
│ - Context Mgr │
└────────┬────────┘
│ Taskwarrior Commands
▼
┌─────────────────┐
│ Taskwarrior │
│ (task CLI) │
└─────────────────┘发展
以开发模式运行
npm run dev测试
运行测试脚本以验证服务器是否正常工作：
node test.js建筑
npm run build配置
服务器使用您现有的Taskwarrior配置(~/.taskrc).您可以像往常一样自定义Taskwarrior设置。
上下文检测
网桥使用当前工作目录并自动检测项目上下文。 不使用硬编码路径或特定项目名称。
票务集成
将工单任务放置在：
.tickets/
└── DRX-12345/
├── context.md # Ticket context
└── mr-checklist.md # Tasks as checklist items格式为 mr-checklist.md:
- [ ] Update unit tests
- [ ] Add documentation
- [ ] Run linting提示
服务器包括内置提示：
每日评论
制定一天的优先计划，包括今天的任务、紧急事项和建议的下一步行动。
每周计划
用活动项目概述组织下周的任务。
故障排除
“没有rc文件无法继续”
初始化任务战士：
task version未检测到上下文
确保您位于项目目录中或 .task-state.json 在您的工作空间中。
票证同步找不到任务
验证 .tickets//mr-checklist.md 存在并包含复选框项。
贡献
欢迎投稿！请随时提交拉取请求。
许可证
麻省理工学院
作者
紫杉醇
致谢
建在上面 任务战士 -命令行任务管理工具。