Rowbase

Name: Rowbase
Author: djstreet11

本地服务

github.com数据库03 周前更新

代码仓库访问官网

关于 Rowbase

Rowbase 是面向用户和 AI Agent 的数据库客户端，内置 MCP 服务，默认以只读方式连接 MySQL、MariaDB、PostgreSQL 和 SQLite。它结合可视化查询工具与紧凑的 TOON 结果格式。

主要功能

01连接默认只读
02支持 MySQL、MariaDB、PostgreSQL、SQLite
03可视化查询构建与筛选
04模式导航与自动补全
05导出 CSV、JSON、Markdown、SQL
06紧凑的 TOON 结果

适用场景

01让 AI Agent 检查模式并查询数据
02无需编写 SQL 即可构建查询
03通过 SQL 预览检查并保存行编辑

MCP 相关

内置 MCP 服务提供模式发现、抽样、查询、SQL 解释和查找引用等工具。写入需要明确授权；结果采用紧凑的 TOON 格式。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "djstreet11-rowbase": {
      "command": "uvx",
      "args": [
        "rowbase-db"
      ]
    }
  }
}

启动命令uvx rowbase-db

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

安装包

pypirowbase-db0.3.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Rowbase 图标

Rowbase

快速、美观、默认只读的数据库客户端，适用于人类和 AI Agent。
MySQL / MariaDB · PostgreSQL · SQLite · 原生 macOS 应用 · 适用于 macOS、Linux 和 Windows 的单文件应用 · 内置 MCP 服务

Rowbase：带有行检查器的表格浏览器

为什么选择 Rowbase？

默认安全。 每个连接在你另行允许前都处于只读状态，并由四个独立层级强制执行（驱动程序级单条语句、SQL 防护、READ ONLY 事务、超时）。生产环境连接会显示红色强调色。
也为 AI 助手打造。 内置的 MCP 服务让 Claude、Cursor、Codex 等工具能够探索你的架构并查询数据——除非你允许写入，否则均为只读；输出格式（TOON）可节省令牌，并内置使用指南，帮助助手了解如何使用。只需复制粘贴一条提示词即可完成所有设置。
单文件，无需安装程序。 下载适用于 macOS、Linux 或 Windows 的单个二进制文件并运行——无需管理员权限、无需 Python，也无需安装驱动程序。也可使用原生 macOS 应用。
无需 SQL。 像在 DataGrip 中一样，直接通过列标题筛选任意列——从带计数的列表中选择值，或使用包含 / 开头匹配 / 区间 / LIKE / 正则表达式 / NULL；还可在查询构建器中直观构建完整查询（连接、计数与求和、条件、排序），并实时查看生成的 SQL。
用起来顺手。 外键导航（也支持没有外键的 UUID 引用，例如 1C 风格架构）、“被引用方”视图、转置、列选择器、架构感知自动补全、 EXPLAIN 高亮、取消查询、带 SQL 预览的行内编辑、导出为 CSV/JSON/Markdown/SQL、SSH 隧道。
开源，采用 Apache-2.0 许可证。密码保存在操作系统钥匙串中，绝不会写入配置文件。



SQL 编辑器：自动补全，⌘↩ 运行光标所在语句，EXPLAIN，取消	安全编辑行：待处理更改、SQL 预览、一次性原子保存

下载

从 Releases 获取最新版本：

平台	文件	运行方式
macOS（原生应用）	`Rowbase-x.y.z.dmg`	打开后拖到“应用程序”
macOS（单文件）	`rowbase-macos-arm64`	`chmod +x rowbase-macos-arm64 && ./rowbase-macos-arm64`
Ubuntu / Debian	`rowbase_x.y.z_amd64.deb` / `_arm64.deb`	双击 → 安装（或运行 `sudo apt install ./rowbase_.deb`），然后从应用菜单启动 Rowbase*
Linux，无需 root	一条命令	`curl -fsSL https://raw.githubusercontent.com/djstreet11/Rowbase/main/packaging/install.sh \| sh` — 安装到 `~/.local/bin` 和应用菜单
Linux x64 / arm64（单文件）	`rowbase-linux-x64` / `-arm64`	`chmod +x rowbase-linux-* && ./rowbase-linux-x64`（Ubuntu 20.04+、Debian 10+、RHEL 8+）
Windows 10 / 11	`rowbase-windows-x64.exe`	双击

不带参数启动（或从应用菜单启动）时，Rowbase 会在浏览器中打开 Web UI；再次启动只会重新打开页面。下载的 Linux 单文件二进制文件没有“可执行”标志，因此双击不会有任何反应——请使用 .deb 或上面的安装命令，或者运行 chmod +x。目前的构建尚未进行代码签名： macOS → 系统设置 → 隐私与安全性 → 仍要打开；Windows → 更多信息 → 仍要运行。

更新。 Mac 应用：Rowbase → 检查更新…（从 0.3.0 开始）。单文件二进制文件：运行 rowbase update，或点击 Web UI 中的更新按钮。通过 PyPI 安装：运行 pipx upgrade rowbase-db。唯一发出的请求是匿名检查 GitHub Releases，每天最多一次——不会收集遥测数据；设置 ROWBASE_NO_UPDATE_CHECK=1 即可关闭。

连接 AI 助手（MCP）

在应用中打开 AI / MCP，点击 复制提示词，然后粘贴到助手中——它会注册服务、读取内置指南并创建可重复使用的技能。也可以手动注册：

claude mcp add rowbase -- /path/to/rowbase mcp          # one-file binary or app
claude mcp add rowbase -- uvx --from rowbase-db rowbase mcp   # straight from PyPI, nothing to download

已作为 io.github.djstreet11/rowbase 列入官方 MCP Registry。

结果以紧凑的 TOON 表格形式返回（比 JSON 少约 40% 的令牌）：

rows[2]{id,customer,total}:
  1,"Smith, Bob",9.50
  2,ann,null
truncated: false

工具：guide、connections、databases、tables、describe、search_schema、sample、count、query、explain、find_ref（仅在允许写入时提供 apply_changes）。详情：docs/MCP.md。

CLI

从 PyPI 安装（pipx install rowbase-db / uv tool install rowbase-db），或使用单文件下载。

rowbase add shop 'postgres://[email protected]/shop?ssh=deploy@bastion'   # read-only unless --rw
rowbase tables -c shop
rowbase q "SELECT * FROM orders WHERE status = 'new'" -c shop --format json
rowbase ui        # web UI on http://127.0.0.1:8765
rowbase mcp       # MCP server (stdio)
rowbase doctor    # environment report
rowbase update    # update a one-file binary in place (--check: only check)

深色模式

从源代码构建

Python 版本：python3 -m venv .venv && .venv/bin/pip install -e . && .venv/bin/rowbase ui
单文件二进制文件：docs/BUILDING.md · macOS 原生应用：cd native && swift build · 发布版本：docs/RELEASING.md
架构与路线图：SPEC.md