Deepresearch MCP Server

ATLAS：任务管理系统

  ](https://github.com/cyanheads/atlas-mcp-server/releases)   ](https://github.com/cyanheads/atlas-mcp-server)

ATLAS（自适应任务和逻辑自动化系统）是一个面向LLM代理的项目、知识和任务管理系统。

基于三层架构构建：

                  +------------------------------------------+
                  |                PROJECT                   |
                  |------------------------------------------|
                  | id: string                               |
                  | name: string                             |
                  | description: string                      |
                  | status: string                           |
                  | urls?: Array|
                  | completionRequirements: string           |
                  | outputFormat: string                     |
                  | taskType: string                         |
                  | createdAt: string                        |
                  | updatedAt: string                        |
                  +----------------+-------------------------+
                            |                    |
                            |                    |
                            v                    v
+----------------------------------+ +----------------------------------+
|               TASK               | |            KNOWLEDGE             |
|----------------------------------| |----------------------------------|
| id: string                       | | id: string                       |
| projectId: string                | | projectId: string                |
| title: string                    | | text: string                     |
| description: string              | | tags?: string[]                  |
| priority: string                 | | domain: string                   |
| status: string                   | | citations?: string[]             |
| assignedTo?: string              | | createdAt: string                |
| urls?: Array                  | | updatedAt: string                |
| tags?: string[]                  | |                                  |
| completionRequirements: string   | |                                  |
| outputFormat: string             | |                                  |
| taskType: string                 | |                                  |
| createdAt: string                | |                                  |
| updatedAt: string                | |                                  |
+----------------------------------+ +----------------------------------+

ATLAS作为模型上下文协议（MCP）服务器实现，允许LLM代理与项目管理数据库交互，从而能够管理项目、任务和知识项。

重要版本说明: 版本1.5.4 是最后一个使用SQLite作为数据库的版本。2.0及更高版本已完全重写为使用Neo4j，这需要： - 使用Docker的自托管（Docker compose包含在存储库中） - 使用Neo4j AuraDB云服务：https://neo4j.com/product/auradb/ 2.5.0版本引入了一个新的3节点系统（项目、任务、知识），取代了之前的结构。

目录

• 概述
• 特性
• 安装
• 配置
• 项目结构
• 工具
• 资源
• 数据库备份和还原
• 例子
• 贡献
• 许可证

概述

ATLAS实现了模型上下文协议（MCP），通过以下方式实现了LLM和外部系统之间的标准化通信：

• 客户：Claude Desktop、IDE和其他MCP兼容客户端
• 服务器：用于项目、任务和知识管理的工具和资源
• LLM代理：利用服务器管理功能的AI模型

系统集成

Atlas平台将这些组件整合到一个有凝聚力的系统中：

• 项目任务关系：项目包含代表实现项目目标所需的可操作步骤的任务。任务从其父项目继承上下文，同时提供对单个工作项的精细跟踪。
• 知识集成：项目和任务都可以通过知识项来丰富，为团队成员提供必要的信息和背景。
• 依赖管理：项目和任务都支持依赖关系，允许具有先决条件和顺序执行要求的复杂工作流。
• 统一搜索：该平台提供跨实体搜索功能，允许用户根据各种标准查找相关项目、任务或知识。

特性

项目管理

• 全面跟踪： 通过内置的批量操作支持来管理项目元数据、状态和丰富内容（注释、链接等）。
• 依赖关系处理： 自动验证和跟踪项目间的依赖关系。

任务管理

• 任务生命周期管理： 在任务的整个生命周期中创建、跟踪和更新任务。
• 优先级和分类： 分配优先级，并用标签对任务进行分类，以便更好地组织。
• 依赖性跟踪： 建立任务依赖关系以创建结构化工作流。

知识管理

• 结构化知识库： 维护一个可搜索的项目相关信息存储库。
• 域分类： 按领域和标签组织知识，便于检索。
• 引文支持： 跟踪知识项的来源和参考。

图形数据库集成

• 本地关系管理： 利用Neo4j的ACID兼容事务和优化的查询，实现强大的数据完整性。
• 高级搜索和可扩展性： 使用模糊匹配和通配符执行基于属性的搜索，同时保持高性能。

统一搜索

• 跨实体搜索： 根据内容、元数据或关系查找相关项目、任务或知识。
• 灵活的查询选项： 支持不区分大小写、模糊和高级过滤选项。

安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

1. 配置Neo4j：

# Start Neo4j using Docker
docker-compose up -d

1. 构建项目：

npm run build

配置

环境变量

创建一个 .env 文件基于 .env.example:

# Neo4j Configuration
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password2

# Application Configuration
LOG_LEVEL=info # debug, info, warn, error
NODE_ENV=development # development, production

# Research API Keys
OPENAI_API_KEY=your_openai_api_key
PERPLEXITY_API_KEY=your_perplexity_api_key
XAI_GROK_API_KEY=your_grok_api_key
FIRECRAWL_API_KEY=your_firecrawl_api_key
AGENTSPACE_API_KEY=your_agentspace_api_key
AGENTSPACE_BASE_URL=https://api.agentspace.dev

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"
      }
    }
  }
}

项目结构

代码库遵循模块化结构：

src/
├── config/          # Configuration management (index.ts)
├── index.ts         # Main server entry point
├── mcp/             # MCP server implementation (server.ts)
│   ├── resources/   # MCP resource handlers (index.ts, types.ts, knowledge/, projects/, tasks/)
│   └── tools/       # MCP tool handlers (individual tool directories)
├── services/        # Core application services
│   └── neo4j/       # Neo4j database services (index.ts, driver.ts, backupRestoreService.ts, etc.)
├── types/           # Shared TypeScript type definitions (errors.ts, mcp.ts, tool.ts)
└── utils/           # Utility functions (logger.ts, errorHandler.ts, etc.)

_注：ID生成逻辑主要位于 src/services/neo4j/helpers.ts._

工具

ATLAS为项目、任务和知识管理提供了一套全面的工具，可通过模型上下文协议调用。

项目运营

任务操作

知识操作

搜索操作

研究运营

数据库操作

资源

ATLAS通过标准MCP资源端点公开项目、任务和知识数据。

直接资源

资源模板

数据库备份和还原

ATLAS提供了备份和恢复Neo4j数据库内容的功能。核心逻辑在于 src/services/neo4j/backupRestoreService.ts.

自动备份（注意）

重要提示： 由于效率低下，自动备份功能已被删除。呼叫 triggerBackgroundBackup 在……里面 src/services/neo4j/driver.ts 用注释将其删除。请使用下面描述的手动备份过程来保护您的数据。

备份过程

• 机制：备份过程导出所有 Project, Task，以及 Knowledge 节点及其关系被合并到单独的JSON文件中。
• 输出：每个备份创建一个带时间戳的目录（例如。， atlas-backup-YYYYMMDDHHMMSS)在配置的备份路径内（默认值： ./atlas-backups/).此目录包含 projects.json, tasks.json, knowledge.json，以及 relationships.json.
• 手动备份：您可以使用提供的脚本触发手动备份：

  npm run db:backup

此命令执行 scripts/db-backup.ts，这叫 exportDatabase 功能。

还原过程

• 机制：还原过程首先完全清除现有的Neo4j数据库。然后，它从指定备份目录中的JSON文件导入节点和关系。
• 警告：从备份还原是一种破坏性操作。 它将覆盖Neo4j数据库中的所有当前数据。
• 手动恢复：要从备份目录还原数据库，请使用导入脚本：

  npm run db:import 

替换 使用备份文件夹的实际路径（例如。， ./atlas-backups/atlas-backup-20250326120000).此命令执行 scripts/db-import.ts，这叫 importDatabase 功能。

• 关系处理：导入过程尝试基于以下内容重新创建关系 id 导出期间存储在节点内的属性。确保您的节点具有一致性 id 正确恢复关系的属性。

例子

这 examples/ 该目录包含演示ATLASMCP服务器各种功能的实际示例。

• 备份示例：位于 examples/backup-example/，这显示了由生成的JSON文件的结构和格式 npm run db:backup 命令。请参阅 示例README 了解更多详情。
• 深度研究实例：位于 examples/deep-research-example/，这演示了由生成的输出和结构 atlas_deep_research 工具。它包括一个markdown文件(covington_community_grant_research.md)总结研究计划和JSON文件(full-export.json)包含在创建研究计划后从数据库导出的原始数据。请参阅 示例README 了解更多详情。

贡献

1. 分叉存储库
2. 创建要素分支
3. 用描述性消息提交您的更改
4. 推到分支
5. 创建拉取请求

对于错误和功能请求，请创建问题。

许可证

Apache许可证2.0

______________________________________________________________________

Built with the Model Context Protocol