ATLAS: Task Management System

ATLAS 是一个基于模型上下文协议(MCP)的任务管理系统，专为 LLM 代理设计，使用 Neo4j 图数据库实现三层架构（项目、任务、知识）。

系统架构

ATLAS 基于三层架构：项目包含任务，项目和任务都可以关联知识项。

项目 ──┐
       ├── 任务
知识 ──┘

安装步骤

1. 克隆仓库并安装依赖

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

2. 配置 Neo4j

创建 .env 文件（基于 .env.example）:

NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password2
LOG_LEVEL=info
NODE_ENV=development

3. 启动 Neo4j

docker-compose up -d

4. 构建并运行

npm run build
node dist/index.js

在 MCP 客户端中配置

在您的 MCP 客户端配置文件中添加:

{
  "mcpServers": {
    "atlas": {
      "command": "node",
      "args": ["/path/to/atlas-mcp-server/dist/index.js"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "password2",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}

主要功能

• 项目管理: 创建、查询、更新和删除项目
• 任务管理: 管理任务生命周期，设置优先级和依赖关系
• 知识管理: 维护结构化知识库，支持领域分类和引用
• 统一搜索: 跨实体搜索功能，支持模糊匹配

核心工具示例

项目操作

# 创建项目
atlas_project_create(name="新项目", description="项目描述", status="进行中")

# 列出项目
atlas_project_list()

# 获取项目详情
atlas_project_get(id="project-123")

任务操作

# 创建任务
atlas_task_create(projectId="project-123", title="实现功能", priority="高")

# 列出任务
atlas_task_list(projectId="project-123")

# 更新任务状态
atlas_task_update(id="task-456", status="已完成")

知识操作

# 添加知识项
atlas_knowledge_create(projectId="project-123", text="重要信息", domain="技术")

# 查询知识
atlas_knowledge_search(query="关键词")

重要说明

• 从版本 2.0 开始，ATLAS 已完全重写为使用 Neo4j 数据库
• 版本 2.5.0 引入了新的三节点系统（项目、任务、知识）
• 对于生产环境，请确保正确配置数据库备份

详细文档请参阅 GitHub 仓库。