Repository navigation
v2.2.0 — guided setup and database selection
Set up OmniSQL directly in Claude Code, Codex, or OpenCode:
npx -y omnisql-mcp@latest install- Guided client registration with workspace, read-only, and connection allowlist settings.
- Native Oracle support (#32) and DBeaver MySQL SSL handler support (#31).
- Optional database selection and
list_databasesfor PostgreSQL, MySQL/MariaDB, and SQL Server (#33). - Ships custom workspace project support, SSH tunnels, URL-mode connections, and IAM authentication that were missing from npm 2.0.1 (#30).
- SQLite result and schema fixes, stronger read-only checks, and CLI safe mode.
- Daily update notices on stderr, with an opt-out.
- New logo, setup GIF, database demo GIF, and an FFmpeg walkthrough in the README.
- Manual npm publishing; CI validates builds and the packed server.
Validation: 223 tests, lint, typecheck, formatting, package smoke checks, documentation build, and zero npm audit findings in the server package. CI passed on Node 22/24 with packaged runtime checks on Node 18/20. Live MCP tests used isolated SQLite databases and a temporary PostgreSQL cluster; Oracle was covered by unit and execution-path tests.
Published to npm as omnisql-mcp@2.2.0 under the latest tag. Existing npx setups update when the MCP client restarts. Global installs can update with npm install -g omnisql-mcp@latest. Full changes: CHANGELOG.md.
What's Changed
- fix(postgres): read SSL config from nested DBeaver JSON properties by @hongweihao in #21
- fix: add error handler for sqlite3 spawn to prevent process crash by @aneeskodappana in #25
- feat: add OMNISQL_PROJECT env var to support custom DB client project names by @zerafachris in #27
- add compatibility with aws iam auth custom jdbc driver by @mononen in #29
- feat(connections): allow database override via "/" syntax by @rrsela in #24
- fix(mysql): read TLS settings from DBeaver SSL handler by @leenawat in #31
- feat: native Oracle driver (node-oracledb Thin mode) by @kaizencode-art in #32
- Release 2.2.0: guided setup, database selection, demos, and manual publishing by @srthkdev in #34
New Contributors
- @hongweihao made their first contribution in #21
- @aneeskodappana made their first contribution in #25
- @zerafachris made their first contribution in #27
- @mononen made their first contribution in #29
- @rrsela made their first contribution in #24
- @leenawat made their first contribution in #31
- @kaizencode-art made their first contribution in #32
Full Changelog: v1.3.0...v2.2.0
What's Changed
- fix(postgres): read SSL config from nested DBeaver JSON properties by @hongweihao in #21
- fix: add error handler for sqlite3 spawn to prevent process crash by @aneeskodappana in #25
- feat: add OMNISQL_PROJECT env var to support custom DB client project names by @zerafachris in #27
- add compatibility with aws iam auth custom jdbc driver by @mononen in #29
- feat(connections): allow database override via "/" syntax by @rrsela in #24
- fix(mysql): read TLS settings from DBeaver SSL handler by @leenawat in #31
- feat: native Oracle driver (node-oracledb Thin mode) by @kaizencode-art in #32
- Release 2.2.0: guided setup, database selection, demos, and manual publishing by @srthkdev in #34
New Contributors
- @hongweihao made their first contribution in #21
- @aneeskodappana made their first contribution in #25
- @zerafachris made their first contribution in #27
- @mononen made their first contribution in #29
- @rrsela made their first contribution in #24
- @leenawat made their first contribution in #31
- @kaizencode-art made their first contribution in #32
Full Changelog: v1.3.0...v2.2.0