narwhal
The agent-native database workbench for the terminal. A DBA toolkit, an MCP server, and a vim-mode SQL editor — in one static binary.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
The agent-native database workbench for the terminal. A DBA toolkit, an MCP server, and a vim-mode SQL editor — in one static binary.
Multi-driver TUI database client with a built-in MCP server. Six databases (postgres, mysql, sqlite, duckdb, clickhouse, mssql), vim editing, Lua + WASM plugins, schema diff, audit log.
Install · Quick start · Why narwhal · Docs

narwhal is a terminal database client built around two things every other client misses:
narwhal mcp
and you're wired.Six engines (Postgres, MySQL, SQLite, DuckDB, ClickHouse, SQL Server), three editor modes (vim / basic / emacs), one static binary.
curl -fsSL https://github.com/Nonanti/narwhal/releases/latest/download/install.sh | sh
Other channels — cargo install narwhaldb, Homebrew, AUR, Nix flake,
prebuilt tarballs — are listed in docs/install.md.
narwhal # launches the TUI
Inside:
:add — connection wizard, or :url postgres://user:pass@host/db:open <name> — connect; the sidebar fills with schemas and tablesHeadless:
narwhal exec --conn prod 'SELECT count(*) FROM orders' --format json
narwhal embeds an MCP server over stdio. Run it once and your AI assistant can browse schema, sample data, and run queries against your saved connections — with the same read-only / per-connection guards the TUI uses.
narwhal mcp --read-only
Claude Desktop (~/.config/Claude/claude_desktop_config.json):
{
"mcpServers": {
"narwhal": {
"command": "narwhal",
"args": ["mcp", "--read-only"]
}
}
}
Cursor, Zed, Continue, Aider, and custom clients work the same way.
Full setup: docs/mcp.md.
:open, every driver speaks the
same Connection trait — same streaming, same cancellation, same
schema introspection.:schema-diff
between two connections with dialect-aware DDL emit (Postgres ↔
MySQL ↔ MSSQL ↔ generic).Ctrl-C
cancels mid-run on every backend that supports it.~/.pgpass — no
plaintext-on-disk fallback.~/.ssh/config plumbing
required.Issues and PRs welcome. See CONTRIBUTING.md.
Commit messages follow Conventional
Commits; the four CI checks
(fmt, clippy -D warnings, doc -D warnings, test) must pass.
Dual-licensed under MIT and Apache 2.0, at your option.
Multi-driver TUI database client with a built-in MCP server. Six databases (postgres, mysql, sqlite, duckdb, clickhouse, mssql), vim editing, Lua + WASM plugins, schema diff, audit log.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Narwhal 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 Multi-driver TUI database client with a built-in MCP server. Six databases (postgres, mysql, sqlite, duckdb, clickhouse, mssql), vim editing, Lua + WASM plugins, schema diff, audit log.