Atlas

本地服务

docs.useatlas.dev数据与分析16 周前更新

代码仓库访问官网

关于 Atlas

Atlas 是面向公司分析的开源语义层，供 AI Agent 使用，可在本机或 VPC 中自托管。它区分实时数据查询、经人员批准的事实和原始来源材料，并保留答案的来源信息。

主要功能

01以 YAML 编写分析语义层
02答案标明三类证据来源
03实时、只读且经过校验的数据查询
04事实须经人员批准后采纳
05呈现矛盾主张及各自来源

适用场景

01让 Agent 查询公司数据
02追溯事实的来源与审批人
03检查相互矛盾的说法而不替其定论

MCP 相关

Atlas 提供 MCP 服务，AI 客户端可连接本地实例或自托管实例。README 提供初始化命令，用于配置 Claude Desktop、Cursor 和 Continue 等客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "atlasdevhq-atlas": {
      "command": "npx",
      "args": [
        "-y",
        "@useatlas/mcp"
      ],
      "env": {
        "ATLAS_DATASOURCE_URL": "<ATLAS_DATASOURCE_URL>",
        "ATLAS_PROVIDER": "<ATLAS_PROVIDER>",
        "ATLAS_API_URL": "<ATLAS_API_URL>"
      }
    }
  }
}

启动命令npx -y @useatlas/mcp

需要配置的环境变量

ATLAS_DATASOURCE_URL密钥Analytics datasource URL (postgres, mysql, clickhouse, snowflake, duckdb, bigquery, salesforce). Optional — falls back to a bundled NovaMart SQLite demo when unset.

ATLAS_PROVIDERLLM provider: anthropic, openai, bedrock, ollama, openai-compatible, gateway. Optional — the MCP server does not call an LLM directly (the client does); set this only if you also run Atlas's chat or scheduler.

ATLAS_API_URLURL of a running Atlas API. Optional — defaults to http://localhost:3001. When set, the MCP server inherits the API's connections, semantic layer, and governance.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@useatlas/mcp0.0.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Atlas

Atlas 为 AI Agent 提供可信的公司事实：每条事实都附带来源、日期和批准者姓名。开源，可在你的 VPC 中运行。

托管服务已关闭。 我曾在 useatlas.dev 以托管服务的形式运行 Atlas，直到 2026 年 9 月，现在已将其关闭，托管演示版和 docs.useatlas.dev 也一并关闭。Atlas 将继续作为开源项目提供：下文所有内容都可在你自己的机器或 VPC 中运行。文档位于 apps/docs/content。

只需一条命令，即可让 Claude Desktop、Cursor 或 Continue 连接到本地 Atlas。如果未配置数据源，它会使用内置的 NovaMart 演示数据：

bunx @useatlas/mcp init --local --write

重启客户端，然后询问它关于 NovaMart 订单的问题。（对于 Claude Code、VS Code 和其他客户端，使用相同的命令并添加 --client generic，即可打印供粘贴的配置块。在 WSL2 上，请使用 bun x，而不是 bunx。）

工作原理

Atlas 中有三类内容，每个回答都会说明依据的是哪一类：

经查询的数据 — 通过你编写的语义层，直接从公司自有数据中读取。其真实性由构造方式保证：查询会重新读取实时行数据，无人进行解读，也不会在两次读取之间过时。仅允许 SELECT、单条语句、表名白名单，并且执行前会经过七种验证。
经确认的事实 — 从他人撰写的内容中提取，再由公司内一位具名人员批准。批准者会被记录在案，事实也会附带来源和日期。
原始记录 — 未经编辑的原始资料。它作为证词值得信赖，但不能视为事实。

当经查询的数据与经确认的事实重叠时，前者优先，因此回忆内容不会覆盖数据。未经人员批准，任何内容都不会成为经确认的事实，并且没有任何设置可以关闭这一要求。如果存在矛盾，系统会同时展示两种说法及其来源；Atlas 不会选出胜者。如果某些内容尚未经过查询，覆盖率页面会如实说明，而不会猜测。

运行

可自托管 — 完整的 Atlas 遵循 AGPL 协议，可在你的 VPC 中免费运行；支持 Docker、Railway 或 Vercel。自托管快速入门。
通过 AI Agent 使用 — 对本地 Atlas 运行 bunx @useatlas/mcp init --local，或对启用了托管身份验证的自托管 Atlas 运行 bunx @useatlas/mcp init --hosted --api-url <your Atlas>。MCP 指南。

其他内容的去向

本 README 曾经涵盖整个产品。现在，每个部分都分别放在文档源中的一个文档页面里：

四种上下文界面（语义层、知识库、学习到的模式、Company Atlas）以及答案的呈现位置 — 介绍
YAML 语义层和完整的 orders.yml 示例 — 语义层
NovaMart 数据集和标准问题 — 演示数据集
本地脚手架（bun create atlas-agent）— 自托管快速入门
可嵌入的小组件和 React 组件 — 嵌入小组件
Atlas 与 Genie、Cortex Analyst、Hyper、Glean 及文本转 SQL 同类产品的对比 — 对比
部署按钮、启动模板和 Docker Compose — 部署
SQL 验证管线和沙箱威胁模型 — SQL 验证、沙箱架构
环境变量 — 参考和 .env.example
插件、数据源、聊天平台和连接器 — 插件编写、集成
支持的数据库和 LLM 提供商 — 连接数据、模型路由
知识库、仪表板和接入自有前端 — 知识库、仪表板、框架
CLI（atlas init、atlas diff 等）— CLI 参考
monorepo 布局和开发环境设置 — CONTRIBUTING.md
开源内容和商业内容 — 企业版界限

致谢

Atlas 的灵感来自 Abhi Sivasailam 在 Vercel 内部数据 Agent d0 上的工作，以及开源的 vercel-labs/oss-data-analyst 模板。核心理念——构建丰富的语义层、信任模型，并让工具界面保持精简——源自这项工作。

许可证

服务端和核心包采用 AGPL-3.0：如果你修改服务端并向用户提供服务，就必须共享这些修改。客户端库（@useatlas/sdk、@useatlas/react、@useatlas/types、@useatlas/plugin-sdk、@useatlas/mcp）和所有插件采用 MIT。ee/ 目录中的源代码可依据商业许可证获取；Atlas 正常运行所需的内容不受其限制，只有治理、便利性和规模相关功能受限。完整清单：企业版界限。