ATLAS MCP Server

概述

ATLAS（自适应任务与逻辑自动化系统）是一个 Model Context Protocol (MCP) 服务器，为大语言模型提供分层任务管理功能，帮助处理复杂任务及其依赖关系。

安装

git clone https://github.com/cyanheads/atlas-mcp-server.git
cd atlas-mcp-server
npm install

配置

在 MCP 客户端设置中添加以下配置：

{
  "mcpServers": {
    "atlas": {
      "command": "node",
      "args": ["/path/to/atlas-mcp-server/build/index.js"],
      "env": {
        "ATLAS_STORAGE_DIR": "/path/to/storage/directory",
        "ATLAS_STORAGE_NAME": "atlas-tasks",
        "NODE_ENV": "production"
      }
    }
  }
}

基本使用

创建任务

{
  "path": "project/backend",
  "name": "后端开发",
  "type": "GROUP",
  "description": "实现核心后端服务",
  "metadata": {
    "priority": "high",
    "tags": ["backend", "api"]
  }
}

更新任务

{
  "path": "project/backend/api",
  "updates": {
    "status": "IN_PROGRESS",
    "dependencies": ["project/backend/database"],
    "metadata": {
      "progress": 50,
      "assignee": "team-member"
    }
  }
}

查询任务

按状态查询：

{
  "status": "IN_PROGRESS"
}

按路径查询：

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

任务结构

任务支持以下核心属性：

• path: 任务的唯一标识路径 (project/feature/task)
• name: 任务名称
• type: 任务类型 (TASK, GROUP, 或 MILESTONE)
• status: 任务状态 (PENDING, IN_PROGRESS, COMPLETED, FAILED, BLOCKED)
• parentPath: 父任务路径
• dependencies: 依赖任务路径列表
• notes: 文本注释列表
• metadata: 自定义元数据对象

主要特性

• 支持分层任务结构和依赖管理
• 强类型验证和路径安全
• 基于事务的操作和隔离级别
• 高效存储和缓存管理
• 完整的事件跟踪系统

有关完整文档，请参阅项目仓库。