# MCP Task Manager

**Repository Path**: 741852963/mcp-task-manager

## Basic Information

- **Project Name**: MCP Task Manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Task Manager

基于 MCP (Model Context Protocol) 的任务管理工具，支持项目级隔离、任务全生命周期管理和进度跟踪。

## 特性

- 🏗️ **项目隔离** - 每个项目独立任务空间，通过路径自动识别项目
- 📋 **全生命周期** - 创建→进行中→完成/取消，严格状态机驱动
- 📊 **进度跟踪** - 百分比进度、子任务拆分、依赖关系
- 🔒 **资源安全** - 优雅退出，WAL checkpoint 确保无残留锁文件
- 🚀 **零依赖** - SQLite 嵌入式存储，单二进制文件

## 快速开始

### 构建

```bash
go build -o bin/mcp-task-manager ./cmd/mcp-task-manager
```

### 配置

在 AI Agent 的 MCP 配置中添加：

```json
{
  "mcpServers": {
    "mcp-task-manager": {
      "command": "/path/to/mcp-task-manager",
      "args": ["serve"],
      "env": {
        "MCP_TASK_MANAGER_DB_PATH": "/optional/custom/db/path.db"
      }
    }
  }
}
```

### 命令行

```bash
mcp-task-manager serve      # 启动 MCP Server (Stdio 模式)
mcp-task-manager version    # 显示版本信息
mcp-task-manager --help     # 帮助
```

## 工具列表

### 项目管理

| 工具 | 描述 |
|------|------|
| `project_create` | 创建项目空间 |
| `project_list` | 列出所有项目 |
| `project_get` | 获取项目详情 |
| `project_delete` | 删除项目 |
| `project_archive` | 归档项目 |

### 任务管理

| 工具 | 描述 |
|------|------|
| `task_create` | 创建任务 |
| `task_get` | 获取任务详情（含子任务和依赖） |
| `task_update` | 更新任务属性 |
| `task_delete` | 删除任务 |
| `task_list` | 列出任务（支持筛选/分页/搜索） |

### 状态与进度

| 工具 | 描述 |
|------|------|
| `task_transition` | 变更任务状态 (start/complete/block/unblock/cancel/reopen) |
| `task_set_progress` | 设置任务进度 (0-100) |

### 依赖管理

| 工具 | 描述 |
|------|------|
| `task_add_dependency` | 添加前置依赖（含循环检测） |
| `task_remove_dependency` | 移除前置依赖 |

### 统计

| 工具 | 描述 |
|------|------|
| `task_stats` | 获取任务统计（按状态/优先级/平均进度） |

## 状态机

```
pending ──start──▶ in_progress ──complete──▶ completed
   │                  │    │                     │
   │              block│    │cancel          reopen│
   │                  │    │                     │
   │                  ▼    ▼                     ▼
   │              blocked cancelled          in_progress
   │                  │
   └──cancel──▶cancelled◀──unblock─┘
```

## 技术栈

- Go 1.23+
- [MCP Go SDK](https://github.com/modelcontextprotocol/go-sdk) v1.6.1
- SQLite (WAL mode)
- Cobra CLI

## 开发

```bash
make build    # 构建
make test     # 运行测试
make clean    # 清理
```

## 许可证

MIT License