ATLAS MCP Server

基本能力

产品定位

ATLAS MCP Server 是一个任务管理和自动化系统，专门为大型语言模型（LLMs）设计，提供结构化的任务管理和上下文支持。

核心功能

• 任务管理：支持层次化任务结构，包括父-子关系、状态管理（如 PENDING, IN_PROGRESS, COMPLETED 等）和依赖跟踪。
• 路径验证与安全：防止目录遍历、特殊字符验证、路径深度限制等。
• 事务管理：支持隔离级别、嵌套事务、自动回滚等。
• 存储与性能：使用 SQLite 作为后端存储，支持 WAL 模式、LRU 缓存和批量操作。
• 验证与安全：使用 Zod 进行输入验证，防止循环依赖，确保状态转换的有效性。
• 监控与维护：提供全面的事件系统、内存使用监控和数据库优化工具。
• 错误处理：详细的错误代码和消息，支持事务回滚和可重试操作。

适用场景

• 复杂任务管理：适用于需要层次化任务管理的场景，如项目管理、工作流自动化。
• LLM 集成：为 LLMs 提供结构化的任务管理能力，增强其处理复杂任务的能力。
• 开发工具：可作为开发工具的一部分，用于任务跟踪和依赖管理。

工具列表

1. create_task：创建任务，包括路径验证和依赖检查。
2. update_task：更新任务状态和依赖关系。
3. bulk_task_operations：原子性执行多个任务操作。
4. get_tasks_by_status：按状态检索任务。
5. get_tasks_by_path：使用 glob 模式搜索任务。
6. get_subtasks：列出直接子任务。
7. vacuum_database：优化数据库存储和性能。
8. repair_relationships：修复任务关系不一致。
9. clear_all_tasks：重置数据库（需确认）。

常见问题解答

1. 路径深度验证：当前对深度路径（>5 层）的验证不够严格。
2. 级联删除：某些深层路径任务可能在父任务删除后仍然存在。
3. 事务管理：批量操作在嵌套事务中可能失败，clear_all_tasks 存在事务问题。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆仓库并安装依赖：

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

安装教程

1. 克隆仓库并安装依赖（同上）。
2. 配置 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"
      }
    }
  }
}

调试方式

1. 运行构建和测试命令：

npm run build
npm test

1. 使用 npm run watch 监控更改并自动重新构建。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。