克劳德任务mcp
Claude Code的本地任务管理MCP服务器。将其视为本地Jira——无需注册，无需平台，只需存储库中的SQLite文件。
任务范围为当前项目目录，并存储在 .claude-tasks/tasks.db （忽略了）。Claude Code通过stdio连接到服务器，可以在工作时创建、更新和查询任务。
为什么？
Claude Code每次会话都会冷启动。在一个真实的项目中，这意味着你要么烧毁上下文，重新解释你在哪里，尝试了什么，被阻止了什么——要么你不费心，在会话之间失去连续性。
claude任务mcp为claude提供了一个结构化存储，它可以在会话开始时查询：正在进行什么，什么阻碍了什么，为什么做出决定。Claude可以询问任务服务器并返回结构化事实，而不是从git历史和内存中重建状态。
审计历史记录特别有用。每个阶段的更改、字段更新和注释都会记录下来，并注明是谁做的以及何时做的。你可以问克劳德“为什么我们改变了这项任务的方法？”并从记录的上下文中得到一个真实的答案，而不是猜测。
web UI使它变得有形——大多数MCP工具都是不可见的，但有一个你可以实际查看的仪表板会鼓励你保持任务状态的准确性，这就是让整个事情工作的原因。
主要警告：只有任务状态保持最新，它才能提供价值。在实践中，Claude在工作时会自动完成大部分工作——创建任务、更新阶段、添加注释——因此开销很低。
特性
- 从您的仓库名称导出的人类可读任务ID(
CTM-0001,LOT-0042) - 工作流程阶段：
ideation → design → refinement → estimated → planned → in-progress → complete → deployed - 与常规提交一致的任务类型：
feat,fix,docs,refactor,test,chore,perf,ci - 优先级：
low,medium,high - 受让人和到期日字段
- 评论、任务链接（块/依赖/相关）
- 完整的审计历史记录——每一项更改都记录了更改的人和时间
- 具有板视图和日历视图的Web UI仪表板
- 零配置——首次使用时自动初始化
安装
git clone https://github.com/TheDavidGilbert/claude-task-mcp
cd claude-task-mcp
npm install
npm run buildClaude代码配置
使用 claude mcp add CLI用于注册服务器。MCP服务器存储在 ~/.claude.json --做 不 添加 mcpServers 到 ~/.claude/settings.json，该字段无效。
全球 （一个服务器，跨所有repos-pass工作 project_path 每次通话）：
claude mcp add --scope user tasks node "/absolute/path/to/claude-task-mcp/dist/index.js"每次回购 （无需通过 project_path 在每次调用时——从仓库内部运行）：
claude mcp add --scope local tasks node "/absolute/path/to/claude-task-mcp/dist/index.js" \
-e CLAUDE_TASKS_CWD="/absolute/path/to/your/repo"注： 默认范围为claude mcp add是local（项目层面）。始终指定--scope user对于全球注册，否则它将仅适用于当前项目。
添加后，重新启动Claude Code并运行 /mcp 确认 tasks 服务器已连接。
CLAUDE.md惯例
只有当Claude遵循一致的任务卫生时，服务器才能提供全部价值。将以下内容添加到您的项目中 CLAUDE.md 制定这些公约：
## Task management
This project uses claude-task-mcp for task tracking. Follow these conventions on every session and every piece of work.
### Session start
Call `list_tasks` filtered to `stage: in-progress` before doing anything else. Use the results to understand what is currently in flight and whether any prior context is relevant to the current request.
### Working on a task
- When you begin work on a task, update its stage to `in-progress`
- Reference the task ID in commit messages: `feat: add login page [CTM-0012]`
- When work is complete, update the stage to `complete`
- If the work has been deployed or merged to main, update to `deployed`
### When to add a comment
Add a comment to the task whenever:
- Significant progress has been made — summarise what changed and why
- A non-obvious decision was made — record the reasoning so future sessions have context
- The approach changed — explain why the original plan was abandoned
- You hit a blocker — describe what is blocking and link any related tasks
Comments are the primary way context survives across sessions. Prefer a brief comment over none.
### Linking tasks
Use `link_tasks` to record relationships:
- `blocks` / `blocked-by` — one task cannot proceed until another is resolved
- `relates-to` — tasks share context or affect the same area of the codebase会话开始查询是最重要的习惯，它使Claude能够连贯地继续工作，而无需重新解释当前状态。
网页用户界面
服务器会自动启动MCP服务器旁边的本地web仪表板：
http://localhost:7654端口默认为 7654 并且可以用以下命令覆盖 CLAUDE_TASKS_PORT 环境变量。
董事会视图
默认视图位于 / 显示可筛选列表中的所有任务。您可以使用顶部的控件按阶段、类型和优先级进行筛选。单击任务ID打开详细信息页面，其中显示了描述、注释、链接的任务和完整的审核历史记录。
日历视图
日历视图位于 /calendar 在月度网格中按截止日期绘制任务。使用“上一页/下一页”控件在月份之间导航。任务在到期日显示为颜色编码的芯片（按阶段），每个芯片都链接到任务详细信息页面。
http://localhost:7654/calendar?path=/your/repo&year=2025&month=12工具
| 工具 | 必需 | 可选 |
|---|---|---|
create_task | title, type | description, priority, stage, estimate, assignee, due_date, actor, project_path |
get_task | task_id | project_path |
update_task | task_id +≥1个字段 | title, description, type, priority, stage, estimate, assignee, due_date, actor, project_path |
list_tasks | — | stage, type, priority, project_path |
add_comment | task_id, body | actor, project_path |
link_tasks | from_task_id, to_task_id, link_type | actor, project_path |
get_project_info | — | project_path |
任务字段
| 字段 | 类型 | 描述 |
|---|---|---|
assignee | string | 负责人的自由文本用户名或显示名称 |
due_date | string | ISO 8601日期，例如。 2025-12-31 --用于在日历视图中绘制任务 |
actor | string | 在审核历史记录中将操作归因于的用户名 |
任务历史记录
每个突变都记录在任务附带的审计日志中：
| 事件 | 记录时间 |
|---|---|
created | 任务首先创建 |
stage_changed | The stage 字段已更新--显示新旧阶段 |
field_changed | 任何其他字段都会更新——显示字段名称、旧值、新值 |
comment_added | 附加评论 |
link_added | 在两个任务之间创建链接 |
传递可选 actor 任何变异工具的参数，以将更改归因于特定用户。历史记录在web UI的任务详细信息页面上可见。
工作流阶段
ideation → design → refinement → estimated → planned → in-progress → complete → deployed项目前缀生成
前缀来源于首次使用时仓库的目录名：
| 目录名称 | 前缀 |
|---|---|
claude-task-mcp | CTM |
language-server | LS |
my-awesome-project | MAP |
发展
npm run dev # run with tsx (no build step)
npm run build # compile to dist/
npm run clean # remove dist/MCP检验员测试
npx @modelcontextprotocol/inspector node dist/index.js打开 http://localhost:5173 以交互方式驱动所有工具。
微笑。
添加 .claude-tasks/ 到 每个项目 它使用此服务器。SQLite数据库由MCP服务器进程保持开放，这意味着：
- Git在锁定状态下的操作
.db文件将在Windows上失败或行为不可预测 - SQLite也写
-wal和-shm数据库打开时，将日志文件与数据库放在一起——在会话中期提交这些日志文件会损坏快照 - 数据库是本地状态（任务ID、历史记录），在计算机之外没有意义
.claude-tasks/此回购属于自己 .gitignore 已经包含此条目作为示例。如果您忘记并意外暂存文件，请运行：
git rm --cached .claude-tasks/tasks.db
echo '.claude-tasks/' >> .gitignore许可证
麻省理工学院