MCP Task Manager Server

🚀 MCP 任务管理器服务器

MCP 任务管理器服务器是一款基于 Node.js 的实用工具，专注于任务数据的管理与操作。它借助一组遵循 MCP 协议的工具，提供了如创建、更新、删除任务等一系列服务，为用户带来便捷的任务管理体验。

🚀 快速开始

MCP 任务管理器服务器是一个基于 Node.js 的工具，用于管理和操作任务数据。它通过实现一组 MCP 协议定义的工具来提供服务，包括创建、更新、删除任务及相关操作。

先决条件

• Node.js (推荐使用 LTS 版本)
• npm

安装依赖

npm install

开发模式运行

npm run dev

开发模式下，服务器会自动加载代码变化（通过 nodemon），并在标准输出打印日志。默认情况下，日志文件将写入 ./data/taskmanager.db。

生产环境构建

npm run build

生产环境运行

npm start

✨ 主要特性

支持的任务操作

• 创建新任务
• 更新现有任务
• 删除任务及其子任务和依赖关系
• 读取任务列表
• 导出/导入任务数据

数据库管理

• 使用 SQLite 数据库存储任务数据，默认路径为 ./data/taskmanager.db
• 支持通过环境变量配置数据库路径 (DATABASE_PATH)

日志记录

• 提供不同级别的日志输出（调试、信息、警告、错误）
• 默认日志级别为 info，可通过环境变量 LOG_LEVEL 修改

工具实现

• 每个任务操作都有对应的工具类和参数验证（使用 Zod 库）

📦 安装指南

安装依赖

npm install

开发模式运行

npm run dev

生产环境构建

npm run build

生产环境运行

npm start

📚 详细文档

配置

数据库路径

通过设置 DATABASE_PATH 环境变量可以修改默认的 SQLite 数据库路径。例如：

DATABASE_PATH=./mydb.db npm run dev

日志级别

通过 LOG_LEVEL 环境变量设置日志输出级别，可选值为：debug, info, warn, error。例如：

LOG_LEVEL=debug npm run dev

项目结构

MCP-TaskManager/
├── src/
│   ├── config/                  # 配置管理模块
│   ├── db/                      # 数据库相关代码（包含 schema.sql）
│   ├── repositories/            # 数据访问层（SQLite 操作）
│   ├── services/                # 核心业务逻辑实现
│   ├── tools/                   # MCP 工具定义（Params.ts 和 Tool.ts）
│   ├── types/                  # 共享的 TypeScript 接口
│   └── utils/                 # 日志、错误处理等工具函数
├── dist/                       # 编译后的 JavaScript 输出目录
├── docs/                      # 文档和规范文件（PRD, RFC 等）
├── data/                     # 默认 SQLite 数据库存储路径（自动创建）
└── tasks.md                   # 开发任务跟踪文件

代码风格与质量管理

代码格式化

使用 prettier 格式化代码，确保一致性和可读性。配置文件：.eslintrc.json, .prettierrc.json

静态代码检查

使用 ESLint 和 TypeScript 进行代码质量检查。在开发过程中，通过 Husky 和 lint-staged 实现自动检查。

单元测试

提供完整的单元测试用例（位于 src/test/ 目录）。可以通过以下命令运行测试：

npm test

项目目标

1. 提供一个可靠的任务管理工具，支持复杂任务依赖关系和子任务结构。
2. 实现 MCP 协议定义的接口，确保与其他系统的兼容性。
3. 保证代码的可维护性和扩展性，便于后续功能增强。

使用场景

• 个人任务管理：用户可以通过命令行或图形界面创建、更新和删除任务。
• 团队协作工具：支持多用户同时操作（需结合身份验证模块）。
• 自动化流程：通过 API 调用集成到其他系统中，实现任务自动化。

接下来步骤

1. 安装依赖并启动服务器：

npm install && npm run dev

2. 查看默认日志输出或数据库文件。
3. 根据需求修改配置环境变量。

更多详细信息，请参考项目文档和代码实现。