Rowbase

io.github.djstreet11

Safe, read-only-by-default MySQL, PostgreSQL & SQLite access for AI agents. TOON output.

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.djstreet11-rowbase": {4      "command": "uvx",5      "args": [6        "rowbase-db==0.3.0"7      ]8    }9  }10}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx rowbase-db==0.3.0

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.djstreet11-rowbase -- uvx rowbase-db==0.3.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.djstreet11-rowbase": {4      "command": "uvx",5      "args": [6        "rowbase-db==0.3.0"7      ]8    }9  }10}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.3.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Rowbase?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Rowbase need an API key?

No required environment variable is listed on this record.

What transport does Rowbase use?

Rowbase runs locally over stdio.

When was Rowbase last checked?

Last checked 2026-10-28. Safe, read-only-by-default MySQL, PostgreSQL & SQLite access for AI agents. TOON output.

From the publisher

Documentation



SQL editor: autocomplete, ⌘↩ runs the statement under the caret, EXPLAIN, cancel	Edit rows safely: pending changes, SQL preview, one atomic save

Download

Grab the latest from Releases:

Platform	File	How to run
macOS (native app)	`Rowbase-x.y.z.dmg`	open, drag to Applications
macOS (one file)	`rowbase-macos-arm64`	`chmod +x rowbase-macos-arm64 && ./rowbase-macos-arm64`
Ubuntu / Debian	`rowbase_x.y.z_amd64.deb` / `_arm64.deb`	double-click → Install (or `sudo apt install ./rowbase_.deb`), then start Rowbase* from the apps menu
Linux, no root	one command	`curl -fsSL https://raw.githubusercontent.com/djstreet11/Rowbase/main/packaging/install.sh \| sh` — installs to `~/.local/bin` + apps menu
Linux x64 / arm64 (one file)	`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`	double-click

Started without arguments (or from the apps menu), Rowbase opens the web UI in your browser; starting it again just reopens the page. A downloaded Linux one-file binary has no "executable" flag, so a double-click does nothing — use the .deb or the install command above, or chmod +x it. Builds are not code-signed yet: macOS → System Settings → Privacy & Security → Open Anyway; Windows → More info → Run anyway.

Updates. The Mac app: Rowbase → Check for Updates… (from 0.3.0). One-file binaries: rowbase update, or the Update button in the web UI. PyPI installs: pipx upgrade rowbase-db. The only request is an anonymous check of GitHub Releases, at most once a day — no telemetry; turn it off with ROWBASE_NO_UPDATE_CHECK=1.

Connect your AI assistant (MCP)

Open AI / MCP in the app, click Copy prompt, paste it into your assistant — it registers the server, reads the built-in guide and creates a reusable skill. Or register manually:

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

Listed in the official MCP Registry as io.github.djstreet11/rowbase.

Results come back as compact TOON tables (~40% fewer tokens than JSON):

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

Tools: guide, connections, databases, tables, describe, search_schema, sample, count, query, explain, find_ref (+ apply_changes only when you allow writes). Details: docs/MCP.md.

CLI

Install from PyPI (pipx install rowbase-db / uv tool install rowbase-db) or use a one-file download.

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)

Build from source

Python track: python3 -m venv .venv && .venv/bin/pip install -e . && .venv/bin/rowbase ui
One-file binaries: docs/BUILDING.md · Native macOS app: cd native && swift build · releases: docs/RELEASING.md
Architecture & roadmap: SPEC.md

Contributing

Issues, ideas and pull requests are welcome — see CONTRIBUTING.md and the Code of Conduct. If Rowbase is useful to you, a ⭐ helps others find it.

License

Apache-2.0 — see NOTICE and THIRD_PARTY_LICENSES.md.

Rowbase

io.github.djstreet11

Safe, read-only-by-default MySQL, PostgreSQL & SQLite access for AI agents. TOON output.

Databases

Add to Cursor Add to VS Code Run on PlugMCP

GitHub Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.djstreet11-rowbase": {4      "command": "uvx",5      "args": [6        "rowbase-db==0.3.0"7      ]8    }9  }10}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx rowbase-db==0.3.0

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.djstreet11-rowbase -- uvx rowbase-db==0.3.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.djstreet11-rowbase": {4      "command": "uvx",5      "args": [6        "rowbase-db==0.3.0"7      ]8    }9  }10}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.3.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Rowbase?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Rowbase need an API key?

No required environment variable is listed on this record.

What transport does Rowbase use?

Rowbase runs locally over stdio.

When was Rowbase last checked?

Last checked 2026-10-28. Safe, read-only-by-default MySQL, PostgreSQL & SQLite access for AI agents. TOON output.

From the publisher

Documentation



SQL editor: autocomplete, ⌘↩ runs the statement under the caret, EXPLAIN, cancel	Edit rows safely: pending changes, SQL preview, one atomic save

Download

Grab the latest from Releases:

Platform	File	How to run
macOS (native app)	`Rowbase-x.y.z.dmg`	open, drag to Applications
macOS (one file)	`rowbase-macos-arm64`	`chmod +x rowbase-macos-arm64 && ./rowbase-macos-arm64`
Ubuntu / Debian	`rowbase_x.y.z_amd64.deb` / `_arm64.deb`	double-click → Install (or `sudo apt install ./rowbase_.deb`), then start Rowbase* from the apps menu
Linux, no root	one command	`curl -fsSL https://raw.githubusercontent.com/djstreet11/Rowbase/main/packaging/install.sh \| sh` — installs to `~/.local/bin` + apps menu
Linux x64 / arm64 (one file)	`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`	double-click

Connect your AI assistant (MCP)

Open AI / MCP in the app, click Copy prompt, paste it into your assistant — it registers the server, reads the built-in guide and creates a reusable skill. Or register manually:

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

Listed in the official MCP Registry as io.github.djstreet11/rowbase.

Results come back as compact TOON tables (~40% fewer tokens than JSON):

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

CLI

Install from PyPI (pipx install rowbase-db / uv tool install rowbase-db) or use a one-file download.

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)

Build from source

Python track: python3 -m venv .venv && .venv/bin/pip install -e . && .venv/bin/rowbase ui
One-file binaries: docs/BUILDING.md · Native macOS app: cd native && swift build · releases: docs/RELEASING.md
Architecture & roadmap: SPEC.md

Contributing

Issues, ideas and pull requests are welcome — see CONTRIBUTING.md and the Code of Conduct. If Rowbase is useful to you, a ⭐ helps others find it.

License

Apache-2.0 — see NOTICE and THIRD_PARTY_LICENSES.md.