AI导哈

AI数据助手

Dolex是一款B2B数据分析产品，可将AI助手转变为可信赖的数据分析师，支持本地CSV文件、PostgreSQL和MongoDB数据库的数据分析，提供完整的数据审计、查询和可视化功能。

  • by outsidedata
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 outsidedata/dolex

使用说明

 ██████╗   ██████╗  ██╗      ███████╗ ██╗  ██╗
 ██╔══██╗ ██╔═══██╗ ██║      ██╔════╝ ╚██╗██╔╝
 ██║  ██║ ██║   ██║ ██║      █████╗    ╚███╔╝
 ██║  ██║ ██║   ██║ ██║      ██╔══╝    ██╔██╗
 ██████╔╝ ╚██████╔╝ ███████╗ ███████╗ ██╔╝ ██╗
 ╚═════╝   ╚═════╝  ╚══════╝ ╚══════╝ ╚═╝  ╚═╝

Dolex将你的人工智能助手变成了一个数据分析师，你可以信任你自己的数据。

B2B数据分析产品，为您的AI助手提供严格的分析师纪律，处理您自己的文件并归还您保存的工件。

Dolex连接到您的数据——一个CSV文件文件夹，或者一个实时的PostgreSQL或MongoDB数据库——对其进行审计，运行分析，并返回您自己的真实结果。它在本地运行：将其指向CSV的文件夹，它们将作为一个可连接的数据库加载，或者连接Postgres/MongoDB源并就地查询。它分析每一列，对每一列进行分类，并构建一个具有可运行查询的优先级分析计划。每个答案都可以追溯到一个可检查的查询，结果会作为您保留的工件返回。Dolex是一个已发布的npm包，在一个核心上有两个前端：一个是任何AI助手都可以调用的MCP服务器，另一个是你的终端、脚本和管道可以直接运行的命令行工具。

你得到了什么

  • 分析自己的数据。 将Dolex指向CSV文件的文件夹——它们将成为您的助手可以加入的一个数据库——或者连接一个实时的PostgreSQL或MongoDB数据库并就地查询。相同的工具，相同的分析，无论来源如何。
  • 你可以支持的数据。 内置的审计在得出结论之前会显示类型陷阱、哨兵值、泄漏和重复列以及异常值。
  • 严谨对待每一个结果。 完整的列分析和统计数据支持分析，每个发现都可以追溯到您可以检查的查询。
  • 真正的分析计划。 Dolex对您的列进行分类，并生成一个具有优先级的分析计划，其中包含可运行的查询；派生列在会话之间持续存在。
  • 你保留的文物。 结果在43种图表类型中呈现为自包含的HTML或PNG，带有React组件、设计系统和每个结果背后的查询。
  • 到处都有一位随时待命的分析师。 同一核心为您的聊天助手和管道提供服务，并发工作在自己的通道中运行。

安装

npm install -g @outsidedata/dolex

要更新，请执行以下操作：

npm update -g @outsidedata/dolex

可选--PNG导出。 将图表渲染为PNG（ --png 标志和MCP screenshot 工具）需要剧作家，这是 不 默认安装。使用启用一次 npm install playwright && npx playwright install chromium其他所有东西——HTML图表、查询、分析、MCP数据工具——都可以在没有它的情况下工作。

克劳德桌面版

添加到您的配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "dolex": {
      "command": "dolex"
    }
  }
}

克劳德代码

claude mcp add dolex -- dolex

任何MCP客户端

将客户端的服务器命令指向 dolex。由MCP客户端通过stdio启动，它运行服务器。要显式启动它，或确认它从终端启动，请使用子命令：

dolex mcp

命令行

同样的分析引擎、查询层和43种图表类型离CLI很远——点 在CSV中获取图表、分析计划或数据质量审计。

# Chart a CSV — the pattern matches the shape of the data
dolex visualize sales.csv -i "compare revenue by region"

# Query first, then chart; force a type and palette; render a PNG
# (PNG export is optional — enable it once with:
#    npm install playwright && npx playwright install chromium)
dolex visualize games.csv \
  --sql "SELECT genre, SUM(na_sales) sales FROM video_games_sales GROUP BY 1" \
  -i "sales by genre" --pattern lollipop --palette blueRed --png genre.png

# Refine the last chart — works across separate invocations
dolex refine spec-1a2b3c4d --sort desc --limit 10   # hash printed by visualize

# Explore without charting
dolex check diamonds.csv          # audit data quality + footguns before trusting it
dolex query diamonds.csv "SELECT cut, MEDIAN(price) FROM diamonds GROUP BY 1" --format json
dolex analyze diamonds.csv        # auto analysis plan with ready-to-run SQL
dolex describe diamonds.csv       # column types, roles, stats, sample rows
dolex patterns                    # browse all 43 chart types

# Persisted derived columns (survive across commands via a .dolex.json manifest)
dolex transform diamonds.csv --create price_per_carat --expr "price / carat"
dolex query     diamonds.csv "SELECT cut, AVG(price_per_carat) FROM diamonds GROUP BY 1"
dolex columns   diamonds.csv      # list source / derived / working columns
命令 它的作用
visualize 将CSV/源代码/内联JSON转换为图表（HTML，可选PNG）
refine 按哈希值调整图表——排序、筛选、调色板、开关类型
query 运行SQL并打印行(table / json / csv / ndjson)
analyze 使用准备运行的SQL自动生成分析计划
describe 配置文件列：类型、角色、统计数据、示例行
check 不良数据和脚踏炮的审计（类型陷阱、哨兵、重复/泄漏的柱子……）
transform 添加持久派生列(--create … --expr …)
columns 按层列出列（源/派生/工作）
drop 删除派生/工作列
patterns 列出43个图表模式，或详细显示一个
sources 注册和管理数据源——CSV、Postgres、MongoDB（与MCP服务器共享）
deps 报告此环境中可用的数据源和可选功能
mcp 运行MCP stdio服务器

图表默认为 ~/.dolex/charts/；管道友好型 --stdout / --json. 完整参考： docs/CLI.md.

数据源

无论您的数据是文件还是实时数据库，Dolex的工作原理都是一样的。指向：

  • CSV --单个文件或整个文件夹，作为一个可连接的内存数据库加载（后台为SQLite）。
  • PostgreSQL --用真正的SQL就地查询的实时数据库；声明的外键直接从模式中读取。
  • MongoDB --集合被分析为表，并使用聚合管道进行查询。

Postgres和MongoDB驱动程序是 可选的 --基础安装保持倾斜，两者都不需要。跑 dolex deps （或向助理询问 capabilities)查看此处准备好了哪些源代码，以及启用缺失内容的确切一行命令，这样您就会得到一个安装提示，而不是崩溃。凭据不在注册表文件中：在连接时从env-var读取Postgres密码，即使数据库关闭，也可以注册源，然后用 dolex sources test /the test_source 工具一旦启动。

# CSV stays the zero-config default
dolex sources add sales ./data/sales.csv

# Live databases — driver installed on demand, secret via env var
dolex sources add warehouse --type postgres --host db.internal --database analytics --user reader --password-env PGPASSWORD
dolex sources add events    --type mongodb  --host localhost --port 27017 --database app
dolex sources test warehouse       # confirm it's reachable with its saved credentials

查询引擎

将您的助手指向CSV文件文件夹或实时Postgres/MongoDB数据库，然后开始提问。Dolex分析你的数据——列类型、分布、基数、样本值——为你的助手提供它需要回答的一切。

内置查询语言涵盖了您的助手运行的分析：

聚合: sum, avg, min, max, count, count_distinct, median, stddev, p25, p75, percentile

窗口功能: lag, lead, rank, dense_rank, row_number, running_sum, running_avg, pct_of_total --具有分区和顺序控制

时光倒流：分组方式 day, week, month, quarter, year --自动日期解析

连接：同一源中跨表的内部和左连接，具有点标记字段引用和歧义检测

过滤器：聚合前(filter)之后(having)，与运营商 =, !=, >, >=, <, <=, in, not_in, between, like, is_null, is_not_null

每个查询在执行前都会经过验证——字段名会根据模式进行检查，并对拼写错误给出模糊的“你是说什么？”建议。

43图案

类别 它们的用途
比较 （9） 条形图、分流条形图、斜率图、连通点图、凹凸图、棒棒糖、子弹、分组条形图、瀑布
分布 （7） 柱状图、Beeswarm图、小提琴图、Ridgeline图、条形图、箱形图、密度图
构图 （9） 堆叠酒吧、华夫饼、树状图、日出、圆形包装、公制、甜甜圈、Marimekko、冰柱
时间 （7） 线条、面积、小倍数、闪光网格、日历热图、流图、地平线图
关系 （5） 散射，连通散射，平行坐标，雷达，热图
流动 （4） 桑基，冲积，和弦，漏斗
地理 （2） Choropleth，比例符号——33张离线地图（世界、美国、各大洲、17个国家）

工具

工具 它做什么
load_source 加载数据源——CSV文件/目录、PostgreSQL或MongoDB
list_data 列出加载的数据集
remove_data 删除加载的数据集
capabilities 报告此环境中可用的源类型和可选驱动程序
test_source 对已注册的Postgres/Mongo源进行健康检查（可访问？凭据有效？）
describe_data 配置文件列、统计数据、示例行
analyze_data 自动生成分析计划
query_data 运行查询（CSV/Postgres的SQL；MongoDB的聚合管道）
visualize 数据→ 排名图表推荐（内联、缓存或源+查询）
refine_visualization 在图表上迭代
transform_data 使用表达式创建派生列
promote_columns 将工作列持久化到磁盘
list_transforms 按层列出列（源/派生/工作）
drop_columns 掉落衍生柱或工作柱
clean_column 用Python修复一列 clean(value) --解析日期、空哨兵、规范化类别；预览然后非破坏性应用（需要python3）
list_patterns 浏览全部43图案
export_html 获取原始HTML
screenshot 渲染为PNG
server_status 检查服务器状态
clear_cache 重置

许可证

麻省理工学院

相关 MCP