使用说明

项目简介

ATLAS MCP Server (Adaptive Task & Logic Automation System) 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供项目管理能力。它集成了 Neo4j 图数据库，提供高效的项目管理、团队协作和知识技能功能，帮助 LLM Agent 更好地管理复杂项目。

主要功能点

项目管理: 全面的项目生命周期管理，包括项目元数据、状态跟踪、批量操作、依赖关系处理等。
团队协作: 支持成员和角色管理，实现团队协作和资源共享。
白板系统: 提供实时协作白板工作空间，支持版本控制和模式验证。
知识技能 (ATLAS Skills): 模块化的知识系统，支持知识、最佳实践和编码标准的访问和组合。
图数据库集成: 使用 Neo4j 图数据库存储和管理项目数据，实现高效的关系查询和数据完整性。
数据库备份与恢复: 支持自动化和手动数据库备份与恢复，保障数据安全。

安装步骤

选择安装方式:

方式一：npm 安装 (推荐开发者使用)

npm install atlas-mcp-server

方式二：从源码安装 (推荐普通用户使用)

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

配置 Neo4j 数据库:
- Docker 方式 (推荐): 确保已安装 Docker 和 Docker Compose，然后执行：
```
docker-compose up -d
```
- Neo4j AuraDB 云服务: 访问 Neo4j AuraDB 注册并获取连接信息。
构建项目 (如果从源码安装):
```
npm run build
```

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数，以便建立连接。以下是 ATLAS MCP Server 的客户端配置示例 (JSON 格式)：

{
  "mcpServers": {
    "atlas": {
      "command": "node",
      "args": ["/path/to/atlas-mcp-server/dist/index.js"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687", // Neo4j 连接 URI，Docker 方式默认配置
        "NEO4J_USER": "neo4j",               // Neo4j 用户名，Docker 方式默认配置
        "NEO4J_PASSWORD": "password2",           // Neo4j 密码，Docker 方式默认配置
        "LOG_LEVEL": "info",                 // 日志级别 (debug, info, warn, error)
        "NODE_ENV": "production"              // 运行环境 (development, production)
      }
    }
  }
}

基本使用方法

启动服务器: 如果从源码安装，在项目根目录下执行：
```
npm run start
```
如果使用 npm 安装，则需要在 MCP 客户端配置中指定正确的 'command' 和 'args' 指向 'atlas-mcp-server' 的安装路径。
配置 MCP 客户端: 将上述服务器配置 JSON 添加到您的 MCP 客户端设置中，并根据实际安装路径修改 'args' 中的路径。
连接与使用: 启动 MCP 客户端，客户端将根据配置连接到 ATLAS MCP Server，即可开始使用项目管理、知识技能等功能。

环境变量配置: ATLAS MCP Server 使用 '.env' 文件进行配置，可以参考 '.env.example' 文件创建 '.env' 文件，并修改其中的 Neo4j 连接信息、日志级别等。

重要提示: 2.0 及以上版本使用 Neo4j 数据库，需要配置 Neo4j 环境。1.5.4 版本及以前的版本使用 SQLite 数据库。

关键词

使用说明

信息