Cyanheads Atlas MCP Server

🚀 ATLAS 中文文檔

ATLAS 是一款基於模型上下文協議構建的任務管理工具，能夠幫助團隊高效地組織和跟蹤項目任務。它具備創建、更新、查詢和維護任務的功能，還支持批量操作與數據庫優化，有效提升團隊協作效率。

✨ 主要特性

• 提供創建、更新、查詢和維護任務的功能。
• 支持批量任務操作，確保多個任務變更的一致性。
• 具備多種任務查詢方式，如按狀態、按路徑模式查詢。
• 擁有數據庫優化、關係修復等維護工具。

📦 安裝指南

1. 克隆倉庫：git clone https://github.com/atlas-project.git
2. 安裝依賴：make install-deps
3. 編譯：make build

💻 使用示例

基礎用法

創建任務

通過 create_task 創建新任務時，需要遵循路徑命名規則並確保依賴關係正確：

{
  "path": "project/backend", // 遵循路徑命名規範
  "name": "後端開發",
  "type": "GROUP",
  "description": "實現核心後端服務",
  "metadata": {
    "priority": "high",
    "tags": ["backend", "api"]
  }
}

更新任務

使用 update_task 更新現有任務時，需注意狀態變更和依賴關係的驗證：

{
  "path": "project/backend/api",
  "updates": {
    "status": "IN_PROGRESS", // 驗證依賴關係
    "dependencies": ["project/backend/database"],
    "metadata": {
      "progress": 50,
      "assignee": "團隊成員"
    }
  }
}

按狀態查詢

使用 get_tasks_by_status 根據執行狀態檢索任務：

{
  "status": "IN_PROGRESS"
}

按路徑模式查詢

通過 get_tasks_by_path 使用通配符模式搜索任務：

{
  "pattern": "project/backend/**"
}

高級用法

批量任務操作

通過 bulk_task_operations 執行原子操作，確保多個任務變更的一致性：

{
  "operations": [
    {
      "type": "create",
      "path": "project/frontend",
      "data": {
        "name": "前端開發",
        "type": "GROUP"
      }
    },
    {
      "type": "update",
      "path": "project/backend",
      "data": {
        "status": "COMPLETED"
      }
    }
  ]
}

數據庫優化

利用 vacuum_database 工具優化數據庫性能並更新統計信息：

{
  "analyze": true // 同時更新統計信息
}

關係修復

使用 repair_relationships 修復任務關係中的不一致：

{
  "dryRun": true, // 預覽變更
  "pathPattern": "project/**"
}

清空任務

通過 clear_all_tasks 徹底重置數據庫（需確認操作）：

{
  "confirm": true
}

📚 詳細文檔

最佳實踐

任務管理

• 使用描述性路徑名稱反映層次結構。
• 設置適當的任務類型（GROUP、TASK）。
• 包括詳細的描述以提供上下文。
• 使用元數據存儲自定義字段。
• 謹慎處理依賴關係。
• 維護乾淨的父 - 子關係。

路徑命名

• 使用字母、數字、連字符和下劃線。
• 保持路徑簡短且有意義。
• 路徑以有效項目名稱開頭。
• 避免使用特殊字符。
• 使用正斜槓分隔。
• 控制層級不超過5層。

性能優化

• 使用批量操作處理多個變更。
• 確保查詢模式簡潔高效。
• 定期執行數據庫維護任務。
• 監控系統性能指標。

已知問題

1. 路徑深度驗證不足：當前版本未充分驗證路徑深度，可能導致深層嵌套任務管理複雜。
2. 級聯刪除限制：未實現級聯刪除功能，手動刪除父任務時需謹慎處理子任務。

開發指南

項目結構

• src/main.c：主程序入口
• include atlas.h：核心庫接口
• lib/：第三方依賴庫
• doc/：文檔和示例

貢獻指南

• 提交 ISSUE 報告問題或建議。
• 發送 PR 修復錯誤或添加功能。
• 參與社區討論。

📄 許可證

本項目遵循 MIT 許可證，具體條款請參閱 LICENSE 文件。

通過以上工具和最佳實踐，ATLAS 助力團隊高效管理複雜項目的任務，提升協作效率。