基本能力
产品定位
MCP Task Manager Server 是一个本地模型上下文协议(MCP)服务器,为客户端驱动的项目和任务管理提供后端工具,使用 SQLite 数据库进行数据存储。
核心功能
- 项目化管理:任务按项目组织,支持创建、删除项目。
- 任务管理:支持添加、列出、展示、更新状态、扩展任务为子任务、获取下一个可执行任务等操作。
- 数据持久化:使用 SQLite 数据库进行本地数据存储。
- 导入/导出:支持将项目数据导出为 JSON 格式,或从 JSON 导入创建新项目。
- MCP 兼容:遵循模型上下文协议,提供标准化的工具定义和通信方式。
适用场景
- 本地任务管理:适用于需要本地化任务管理的场景,如个人任务跟踪、小型团队协作。
- AI 代理集成:可作为 AI 代理的后端,用于管理任务和工作流。
- 脚本自动化:通过脚本调用 MCP 工具,实现任务管理的自动化。
工具列表
createProject
:创建新项目。addTask
:向项目添加新任务。listTasks
:列出项目中的任务,支持过滤和子任务包含。showTask
:获取任务的完整详情。setTaskStatus
:更新任务状态。expandTask
:将任务扩展为子任务。getNextTask
:获取下一个可执行任务。exportProject
:导出项目数据为 JSON。importProject
:从 JSON 导入创建新项目。updateTask
:更新任务详情。deleteTask
:删除任务。deleteProject
:删除项目及其所有数据。
常见问题解答
- 数据库路径:可通过
DATABASE_PATH
环境变量覆盖默认路径(./data/taskmanager.db
)。 - 日志级别:通过
LOG_LEVEL
环境变量设置日志级别(默认info
)。
使用教程
使用依赖
- Node.js:确保已安装 Node.js(推荐 LTS 版本)。
- npm:确保已安装 npm。
安装教程
- 安装依赖:
bash
npm install - 开发模式运行:
bash
npm run dev - 生产构建:
bash
npm run build - 运行生产构建:
bash
npm start
调试方式
- 日志查看:日志以 JSON 格式输出到 stderr。
- 数据库检查:默认数据库文件位于
./data/taskmanager.db
。