Cyanheads Atlas MCP Server

🚀 ATLAS 中文文档

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": "团队成员"
    }
  }
}

批量任务操作

通过 bulk_task_operations 执行原子操作，确保多个任务变更的一致性：

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

按状态查询

使用 get_tasks_by_status 根据执行状态检索任务：

{
  "status": "IN_PROGRESS"
}

按路径模式查询

通过 get_tasks_by_path 使用通配符模式搜索任务：

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

高级用法

数据库优化

利用 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 助力团队高效管理复杂项目的任务，提升协作效率。