Task Manager MCP

🚀 任務管理器指南

該任務管理器可助力開發過程中的任務規劃與跟蹤。藉助集成工具和 API 端點，能有效管理和監控功能請求及其相關任務。

🚀 快速開始

1. 下載代碼庫：從GitHub獲取最新版本。
2. 安裝依賴：運行 npm install 安裝所有必要的包。
3. 配置環境變量：創建 .env 文件並填寫適當的值，例如數據庫連接和 API 密鑰。
4. 啟動服務：執行 node index.js 啟動任務管理器。

✨ 主要特性

計劃特性 (plan_feature)

根據用戶提供的特性描述生成初始任務列表。例如，輸入“添加 JWT 身份驗證”，系統會自動生成設計和實現步驟。

標記任務完成 (mark_task_complete)

當一個任務完成後，使用此工具標記其為已完成，並獲取下一個待處理任務。

獲取下一個任務 (get_next_task)

用於查看特定功能的下一步操作。

審查變化 (review_changes)

對已完成的任務進行審查，確保符合預期要求。

📦 安裝指南

下載代碼庫

可以從GitHub下載最新的代碼庫。

安裝依賴

使用 npm 安裝所需的依賴：

npm install

配置環境變量

創建一個 .env 文件，並添加以下內容：

PORT=3000  # 服務運行的端口
DB_URL=mongodb://localhost:27017/taskdb  # 數據庫連接URL
OPENAI_API_KEY=your_openai_api_key  # OpenAI API密鑰

啟動服務

node index.js

💻 使用示例

基礎用法

計劃特性 (plan_feature)

請求格式：

{
  "featureDescription": "添加JWT身份驗證",
  "userId": "123"
}

響應格式：

{
  "status": "completed",
  "message": "設計身份驗證流程並定義API端點。",
  "taskId": "task_001",
  "featureId": "fea_001"
}

標記任務完成 (mark_task_complete)

請求格式：

{
  "taskId": "task_001",
  "featureId": "fea_001"
}

響應格式：

{
  "status": "completed",
  "message": "完成設計身份驗證流程。",
  "nextTaskId": "task_002",
  "featureId": "fea_001"
}

獲取下一個任務 (get_next_task)

請求格式：

{
  "featureId": "fea_001"
}

響應格式：

{
  "status": "completed",
  "message": "實現身份驗證API端點。",
  "taskId": "task_002",
  "featureId": "fea_001"
}

審查變化 (review_changes)

請求格式：

{
  "featureId": "fea_001"
}

響應格式：

{
  "status": "completed",
  "message": "代碼審查通過，準備合併。",
  "featureId": "fea_001"
}

📚 詳細文檔

API 文檔

基礎 URL

所有請求應發送到 http://localhost:3000。

獲取所有功能

GET /api/features

響應示例

[
  {
    "id": "fea_001",
    "description": "添加JWT身份驗證"
  },
  {
    "id": "fea_002",
    "description": "實現用戶認證"
  }
]

獲取特定功能的任務

GET /api/tasks/fea_001

響應示例

[
  {
    "id": "task_001",
    "description": "設計身份驗證流程",
    "status": "completed"
  },
  {
    "id": "task_002",
    "description": "實現身份驗證API端點",
    "status": "in-progress"
  }
]

常見問題

• 問：如何處理數據庫連接錯誤？

  答：檢查 MongoDB 是否運行，確保 .env 文件中的 DB_URL 正確。

• 問：無法訪問 API 端點？

  答：確認服務已成功啟動，並查看控制檯是否有錯誤信息。

更新日誌

版本 1.0.0

• 初始發佈，包含基本任務管理功能。

版本 2.0.0

• 增加了審查變化的功能。
• 改進了 API 文檔。

集成指南

與 OpenAI 的集成

該任務管理器集成了 OpenAI 的 API，用於自動生成任務分解和代碼審查。

配置 OpenAI

確保在 .env 文件中填寫 OPENAI_API_KEY：

OPENAI_API_KEY=your_openai_api_key

使用 OpenAI 進行任務分解

當使用 plan_feature 工具時，系統會自動調用 OpenAI 的 API 來生成任務列表。

與 MongoDB 的集成

數據存儲在 MongoDB 中，默認連接字符串為 mongodb://localhost:27017/taskdb。可以修改 .env 文件中的 DB_URL 以使用其他數據庫。

安全指南

數據加密

所有敏感信息（如 API 密鑰）均應加密存儲，並避免在代碼中明文出現。

身份驗證

建議在生產環境中啟用身份驗證，限制對 API 端點的訪問。

日誌記錄

實施詳細的日誌記錄機制，便於審計和故障排除。

錯誤處理

• 404 Not Found：請求的資源不存在。
• 500 Internal Server Error：服務端發生錯誤。

聯繫與支持

如需幫助或報告問題，請聯繫 support@taskmanager.com。