AI导哈

任务管理服务器

一个为AI代理设计的任务管理服务器，支持多步骤工作跟踪、工作区隔离、子任务、依赖关系和标签分类。

  • by freeformz
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 freeformz/tasks-mcp

使用说明

任务mcp

任务管理 主控程序 Go内置的AI代理服务器。通过工作区隔离、子任务、依赖关系和标签跟踪会话中的多步工作。

特性

  • 工作区感知：任务的范围在项目目录中，因此不同项目中的多个代理不会相互干扰
  • 多过程安全：具有WAL模式的SQLite支持多个MCP服务器实例的并发访问
  • 持久：任务跨会话生存，实现长时间运行的工作跟踪
  • 子任务和依赖关系：将复杂的工作分解为子任务并定义排序约束
  • 标签：对任务进行分类以进行筛选
  • 进展记录：带时间戳的日志条目跟踪所做的事情和时间
  • 克劳德代码挂钩：在会话开始时自动显示待处理的任务，并在停止时提醒正在进行的任务

MCP工具

工具 说明
task_create 创建一个包含标题、描述、优先级、标签、子任务和依赖关系的任务
task_list 列出按状态、标记或父级筛选的任务
task_get 获取完整的任务详细信息，包括子任务和依赖关系
task_update 更新字段，添加/删除标签和依赖项，附加进度说明
task_delete 删除任务及其子任务

安装

go install github.com/freeformz/tasks-mcp@latest

或者拉取Docker镜像：

docker pull ghcr.io/freeformz/tasks-mcp:latest

配置

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "tasks": {
      "type": "stdio",
      "command": "tasks-mcp",
      "args": ["mcp"]
    }
  }
}

码头工人

{
  "mcpServers": {
    "tasks": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "tasks-mcp-data:/data", "ghcr.io/freeformz/tasks-mcp:latest", "mcp"]
    }
  }
}

数据库存储在 /data/tasks.db 在容器内。卷装载会在运行过程中保留它。

挂钩（可选）

添加 .claude/settings.json 对于会话开始和停止提醒的自动任务上下文：

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|compact",
        "hooks": [
          {
            "type": "command",
            "command": "tasks-mcp hooks snapshot",
            "timeout": 10
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "tasks-mcp hooks check-active",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

规则

复制 .claude/rules/taskqueue.md 到你的项目 .claude/rules/ 目录，指示Claude何时以及如何使用任务工具。

数据库

任务存储在SQLite中 ~/.local/share/tasks-mcp/tasks.db数据库在首次运行时自动创建。模式更改是通过SQLite跟踪的版本化迁移来管理的 PRAGMA user_version.

许可证

麻省理工学院

相关 MCP