使用说明

项目简介

MCP任务管理器服务器是一个本地服务器，它实现了 Model Context Protocol (MCP)，为客户端应用（如AI智能体）提供项目和任务管理功能。它使用轻量级的 SQLite 数据库来持久化数据，并提供了一系列符合 MCP 协议的工具，使得客户端能够以标准化的方式与服务器交互，进行任务管理操作。

主要功能点

项目管理：支持创建、删除项目，项目数据导出和导入。
任务管理：支持在项目中创建、查看、更新、删除任务。
任务状态跟踪：可以设置和查询任务的状态（待办、进行中、审核中、已完成）。
任务依赖：支持设置任务之间的依赖关系。
子任务：支持将任务分解为子任务。
优先级：支持为任务设置优先级（高、中、低）。
下一步任务：可以查询项目中下一步可执行的任务。
数据持久化：使用本地 SQLite 数据库存储项目和任务数据。
MCP 协议兼容：完全遵循 Model Context Protocol 协议，提供标准化的工具接口。

安装步骤

前提条件：确保已安装 Node.js (推荐 LTS 版本) 和 npm。
安装依赖：
```
npm install
```

服务器配置

MCP 客户端需要配置以下信息以连接到 MCP 任务管理器服务器。配置信息为 JSON 格式：

{
  "serverName": "mcp-task-manager-server",
  "command": "npm",
  "args": ["start"]
}

配置参数说明：

'serverName': 服务器名称，可以自定义，用于在客户端标识该服务器。
'command': 启动服务器的命令，这里使用 'npm' 命令。
'args': 'command' 命令的参数，'start' 是 'package.json' 中定义的启动脚本，用于启动服务器。

注意：如果您的 Node.js 环境配置不同，可能需要调整 'command' 和 'args'。例如，如果 'node' 命令可以直接在终端中使用，并且您已经构建了生产版本，则可以配置为：

{
  "serverName": "mcp-task-manager-server",
  "command": "node",
  "args": ["dist/server.js"]
}

基本使用方法

启动服务器：
- 开发模式：运行 'npm run dev' 命令，服务器将通过 stdio 接口启动，并输出日志到 stderr。
- 生产模式：先运行 'npm run build' 构建生产版本，然后运行 'npm start' 命令启动服务器。
客户端交互：
- 使用 MCP 客户端（如 AI Agent）配置上述服务器连接信息。
- 客户端可以通过 JSON-RPC 协议向服务器发送请求，调用预定义的工具，例如 'createProject' 创建项目，'addTask' 添加任务，'listTasks' 列出任务等。
- 服务器将根据请求执行相应的操作，并返回 JSON-RPC 响应。
数据库：
- 默认情况下，SQLite 数据库文件 'taskmanager.db' 存储在 './data' 目录下。
- 可以通过设置 'DATABASE_PATH' 环境变量来修改数据库文件路径。
日志级别：
- 可以通过设置 'LOG_LEVEL' 环境变量（例如 'debug', 'info', 'warn', 'error'）来调整日志输出级别。

关键词