Overview

Overview

site icon
2025.04.10 3
TypeScript任务管理项目管理本地存储开发效率
MCP Task Manager Server 是一个本地模型上下文协议(MCP)服务器,为客户端驱动的项目和任务管理提供后端工具,使用 SQLite 数据库进行数据存储。该服务器作为本地 MCP 客户端(如 AI 代理或脚本)的持久化后端,用于管理结构化任务数据,并提供了标准化的工具集供客户端交互。
View on GitHub

Overview

基本能力

产品定位

MCP Task Manager Server 是一个本地模型上下文协议(MCP)服务器,为客户端驱动的项目和任务管理提供后端工具,使用 SQLite 数据库进行数据存储。

核心功能

  • 项目化管理:任务按项目组织,支持创建、删除项目。
  • 任务管理:支持添加、列出、展示、更新状态、扩展任务为子任务、获取下一个可执行任务等操作。
  • 数据持久化:使用 SQLite 数据库进行本地数据存储。
  • 导入/导出:支持将项目数据导出为 JSON 格式,或从 JSON 导入创建新项目。
  • MCP 兼容:遵循模型上下文协议,提供标准化的工具定义和通信方式。

适用场景

  • 本地任务管理:适用于需要本地化任务管理的场景,如个人任务跟踪、小型团队协作。
  • AI 代理集成:可作为 AI 代理的后端,用于管理任务和工作流。
  • 脚本自动化:通过脚本调用 MCP 工具,实现任务管理的自动化。

工具列表

  1. createProject:创建新项目。
  2. addTask:向项目添加新任务。
  3. listTasks:列出项目中的任务,支持过滤和子任务包含。
  4. showTask:获取任务的完整详情。
  5. setTaskStatus:更新任务状态。
  6. expandTask:将任务扩展为子任务。
  7. getNextTask:获取下一个可执行任务。
  8. exportProject:导出项目数据为 JSON。
  9. importProject:从 JSON 导入创建新项目。
  10. updateTask:更新任务详情。
  11. deleteTask:删除任务。
  12. deleteProject:删除项目及其所有数据。

常见问题解答

  • 数据库路径:可通过 DATABASE_PATH 环境变量覆盖默认路径(./data/taskmanager.db)。
  • 日志级别:通过 LOG_LEVEL 环境变量设置日志级别(默认 info)。

使用教程

使用依赖

  1. Node.js:确保已安装 Node.js(推荐 LTS 版本)。
  2. npm:确保已安装 npm。

安装教程

  1. 安装依赖bash npm install
  2. 开发模式运行bash npm run dev
  3. 生产构建bash npm run build
  4. 运行生产构建bash npm start

调试方式

  • 日志查看:日志以 JSON 格式输出到 stderr。
  • 数据库检查:默认数据库文件位于 ./data/taskmanager.db

许可证

该项目遵循 GPL-3.0 开源许可条款,请参阅 GPL-3.0 了解完整条款。