MCP Task Manager Server

一個基於SQLite的本地任務管理服務器，遵循MCP協議，提供項目化任務管理工具，支持創建項目、添加任務、狀態更新、子任務擴展等操作。

開發者工具知識管理與記憶 #任務管理 #本地服務 #MCP協議 #SQLite 本地 .TypeScript

評分 : 2.5分

下載量 : 17

更新時間 : 2025-04-28

什麼是MCP任務管理器?

MCP任務管理器是一個本地運行的後端服務，專門為AI代理或自動化腳本設計，用於管理結構化的任務數據。它將任務按項目分類存儲，並提供標準化的操作接口。

如何使用MCP任務管理器?

通過預定義的MCP協議工具集與服務器交互，包括創建項目、添加任務、更新狀態等操作。客戶端負責業務邏輯，服務器處理數據持久化。

適用場景

適用於需要持久化任務狀態的AI工作流、自動化項目管理腳本、以及需要分步執行復雜任務的本地應用。

主要功能

項目化管理所有任務都歸屬於特定項目，保持工作區清晰有序

完整任務操作支持創建/更新/刪除任務，設置狀態和優先級，管理依賴關係

子任務分解可將複雜任務拆解為可執行的子任務列表

項目導入導出通過JSON格式實現項目數據的遷移和備份

優勢與侷限性

優勢

輕量級SQLite存儲，無需額外數據庫服務

清晰的MCP協議接口，便於客戶端集成

完備的任務關係管理（依賴/子任務）

本地化運行保障數據隱私

侷限性

僅支持單機部署，無多用戶協作功能

無內置用戶界面，需通過客戶端訪問

項目容量受本地存儲限制

如何使用

環境準備

安裝Node.js LTS版本和npm包管理器

安裝依賴

下載項目後安裝所需依賴包

啟動服務

開發模式啟動（帶熱更新）

構建生產版本

編譯TypeScript為生產環境代碼

使用案例

創建開發項目初始化一個軟件開發項目並添加主要功能點作為任務

任務分解將'用戶認證模塊'父任務拆分為具體子任務

常見問題

數據存儲在哪裡？

如何修改數據庫路徑？

刪除的項目能否恢復？

🚀 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                   # 開發任務跟蹤文件