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. 根據需求修改配置環境變量。

更多詳細信息，請參考項目文檔和代碼實現。