feat!: Rename dbeaver-mcp-server → omnisql-mcp (v2.0.0)

Renamed at the request of DBeaver Corporation. The server still reads
connections from the same local DB client workspace (DBeaver-compatible),
only the branding changed.

BREAKING CHANGES:
- npm package: dbeaver-mcp-server → omnisql-mcp
- binary: dbeaver-mcp-server → omnisql-mcp
- env vars: DBEAVER_* → OMNISQL_* (e.g. DBEAVER_READ_ONLY → OMNISQL_READ_ONLY,
  DBEAVER_PATH → OMNISQL_CLI_PATH)
- resource URI scheme: dbeaver:// → omnisql://
- internal classes: DBeaverMCPServer → OmniSQLMCPServer, DBeaverClient →
  WorkspaceClient, DBeaverConfigParser → WorkspaceConfigParser
- interfaces: DBeaverConnection → DatabaseConnection, DBeaverConfig →
  WorkspaceConfig
- removed CLI auto-detection; users must set OMNISQL_CLI_PATH explicitly
  to use the unsupported-driver CLI fallback

Also fixes a broken CI step (npm install -g npm@latest was breaking npm
itself on the runner; Node 22's bundled npm already supports OIDC).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: srthkdev

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -49,7 +49,7 @@ body:
     id: logs
     attributes:
       label: Error logs
-      description: Paste any error messages (run with DBEAVER_DEBUG=true)
+      description: Paste any error messages (run with OMNISQL_DEBUG=true)
       render: shell
 
   - type: checkboxes

.github/workflows/ci.yml

@@ -71,9 +71,6 @@ jobs:
           registry-url: 'https://registry.npmjs.org'
           cache: 'npm'
 
-      - name: Upgrade npm for OIDC support
-        run: npm install -g npm@latest
-
       - name: Install dependencies
         run: npm ci
 
@@ -87,7 +84,7 @@ jobs:
           echo "local_version=$LOCAL_VERSION" >> $GITHUB_OUTPUT
 
           # Check if this version exists on npm
-          NPM_VERSION=$(npm view dbeaver-mcp-server version 2>/dev/null || echo "0.0.0")
+          NPM_VERSION=$(npm view omnisql-mcp version 2>/dev/null || echo "0.0.0")
           echo "npm_version=$NPM_VERSION" >> $GITHUB_OUTPUT
 
           if [ "$LOCAL_VERSION" = "$NPM_VERSION" ]; then

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2026-04-20
+
+### Changed (Breaking)
+- **Renamed package**: `dbeaver-mcp-server` → `omnisql-mcp`. The old npm package is deprecated; install `omnisql-mcp` going forward.
+- **Renamed binary**: `dbeaver-mcp-server` → `omnisql-mcp`.
+- **Renamed environment variables**: All `DBEAVER_*` env vars are now `OMNISQL_*` (for example, the old `DBEAVER_READ_ONLY` is now `OMNISQL_READ_ONLY`, old `DBEAVER_WORKSPACE` is now `OMNISQL_WORKSPACE`, and old `DBEAVER_PATH` is now `OMNISQL_CLI_PATH`). Update your MCP client config.
+- **Renamed resource URI scheme**: `dbeaver://` → `omnisql://` for table schema resources.
+- **Renamed internal classes**: `DBeaverConfigParser` → `WorkspaceConfigParser`, `DBeaverClient` → `WorkspaceClient`, `DBeaverMCPServer` → `OmniSQLMCPServer`. Interfaces `DBeaverConnection` → `DatabaseConnection`, `DBeaverConfig` → `WorkspaceConfig`.
+- **CLI auto-detection removed**: `OMNISQL_CLI_PATH` must now be set explicitly to use the CLI fallback for unsupported drivers. Previously the server attempted to locate the DB client binary in hardcoded install paths.
+
+Functional behavior is otherwise unchanged — the server still reads connections from the same local DB client workspace (DBeaver-compatible).
+
 ## [1.3.0] - 2026-02-16
 
 ### Added
@@ -23,29 +35,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - CI workflow now includes a `publish` job that runs after all checks pass on `main`
-- Pool manager's `isPostgresCompatible()` is now a public method shared with dbeaver-client
+- Pool manager's `isPostgresCompatible()` is now a public method shared with workspace-client
 
 ## [1.2.5] - 2026-02-15
 
 ### Added
-- Connection whitelist via `DBEAVER_ALLOWED_CONNECTIONS` environment variable — restrict which DBeaver connections are visible by ID or name
+- Connection whitelist via `OMNISQL_ALLOWED_CONNECTIONS` environment variable — restrict which workspace connections are visible by ID or name
 - `enforceReadOnly()` query-level enforcement — `execute_query` now strictly allows only read-only statements (SELECT, EXPLAIN, SHOW, DESCRIBE, PRAGMA)
 - Test queries for SAP HANA (`SELECT * FROM DUMMY`) and DB2 (`SYSIBM.SYSDUMMY1`)
 
 ### Fixed
 - **Read-only mode bypass (Issue #19)**: `execute_query` no longer allows write operations (INSERT/UPDATE/DELETE/CREATE/ALTER/DROP). Transaction tools (`begin_transaction`, `commit_transaction`, `rollback_transaction`, `execute_in_transaction`) are now blocked in read-only mode.
-- **Unsupported driver errors (Issue #17)**: DBeaver CLI fallback now provides clear, actionable error messages listing natively supported drivers and workarounds. DBeaver availability is checked before attempting CLI fallback.
+- **Unsupported driver errors (Issue #17)**: CLI fallback now provides clear, actionable error messages listing natively supported drivers and workarounds. CLI availability is checked before attempting fallback.
 - **UPDATE validation regex**: `UPDATE ... SET ... WHERE ...` was incorrectly blocked by the dangerous query filter. The regex now correctly allows UPDATE with WHERE clause.
 
 ### Changed
-- DBeaver CLI fallback uses connection name-based spec for better compatibility
+- CLI fallback uses connection name-based spec for better compatibility
 
 ## [1.2.4] - 2026-01-15
 
 ### Added
 - Native MySQL/MariaDB support via `mysql2` library
-- Read-only mode (`DBEAVER_READ_ONLY=true`) to disable write operations
-- Tool filtering via `DBEAVER_DISABLED_TOOLS` environment variable
+- Read-only mode (`OMNISQL_READ_ONLY=true`) to disable write operations
+- Tool filtering via `OMNISQL_DISABLED_TOOLS` environment variable
 - GitHub Actions CI/CD pipeline
 - ESLint and Prettier configuration
 - Pre-commit hooks via Husky
@@ -74,7 +86,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Native MSSQL/SQL Server support via `mssql` library
-- `xml2js` dependency for DBeaver config parsing
+- `xml2js` for legacy XML workspace config parsing
 
 ### Fixed
 - Missing `xml2js` runtime dependency that broke npm installations
@@ -84,7 +96,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - SSL/TLS support for PostgreSQL connections
-- Credential decryption from DBeaver's credentials-config.json
+- Credential decryption from the workspace credentials-config.json
 
 ### Fixed
 - Authentication failures with PostgreSQL (Issue #8)
@@ -94,17 +106,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Native PostgreSQL support via `pg` library
 - Native SQLite support via sqlite3 CLI
-- DBeaver CLI fallback for unsupported databases
+- CLI fallback for unsupported drivers
 - Business insights tracking feature
 
 ### Changed
-- Query execution no longer requires DBeaver GUI for supported databases
+- Query execution no longer requires the DB client GUI for supported databases
 
 ## [1.1.0] - 2024-09-XX
 
 ### Added
 - Initial MCP server implementation
-- Support for DBeaver 6.x (XML) and 21.x+ (JSON) config formats
+- Support for legacy XML and modern JSON workspace config formats
 - Connection management tools
 - Query execution tools
 - Schema management tools

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 DBeaver MCP Server
+Copyright (c) 2025 Sarthak Jain
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,15 +1,11 @@
-# DBeaver MCP Server
+# OmniSQL MCP
 
-MCP server that provides AI assistants access to databases through DBeaver connections.
+Universal database MCP server — give AI assistants read/write access to your databases using connections already saved in your local DB client workspace (DBeaver-compatible).
 
-[![npm version](https://badge.fury.io/js/dbeaver-mcp-server.svg)](https://www.npmjs.com/package/dbeaver-mcp-server)
+[![npm version](https://badge.fury.io/js/omnisql-mcp.svg)](https://www.npmjs.com/package/omnisql-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 
-<a href="https://glama.ai/mcp/servers/@srthkdev/dbeaver-mcp-server">
-  <img width="380" height="200" src="https://glama.ai/mcp/servers/@srthkdev/dbeaver-mcp-server/badge" alt="DBeaver Server MCP server" />
-</a>
-
 ## Database Support
 
 **Natively supported** (direct driver, fast):
@@ -21,11 +17,11 @@ MCP server that provides AI assistants access to databases through DBeaver conne
 **Postgres-compatible** (routed through `pg` driver automatically):
 - CockroachDB, TimescaleDB, Amazon Redshift, YugabyteDB, AlloyDB, Supabase, Neon, Citus
 
-**Other databases**: Falls back to DBeaver CLI. Requires DBeaver to be installed and the connection configured in your DBeaver workspace. Results vary by DBeaver version.
+**Other databases**: Fall back to an external CLI configured via `OMNISQL_CLI_PATH`. Results vary by CLI.
 
 ## Features
 
-- Uses existing DBeaver connections (no separate config needed)
+- Reuses connections already configured in your local DB client workspace — no duplicate setup
 - Native query execution for PostgreSQL, MySQL/MariaDB, SQLite, SQL Server
 - Connection pooling with configurable pool size and timeouts
 - Transaction support (BEGIN/COMMIT/ROLLBACK)
@@ -41,12 +37,12 @@ MCP server that provides AI assistants access to databases through DBeaver conne
 ## Requirements
 
 - Node.js 18+
-- DBeaver with at least one configured connection
+- A local DB client (DBeaver-compatible) with at least one configured connection
 
 ## Installation
 
 ```bash
-npm install -g dbeaver-mcp-server
+npm install -g omnisql-mcp
 ```
 
 ## Configuration
@@ -58,8 +54,8 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server"
+    "omnisql": {
+      "command": "omnisql-mcp"
     }
   }
 }
@@ -72,8 +68,8 @@ Add to `~/.claude/settings.json`:
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server"
+    "omnisql": {
+      "command": "omnisql-mcp"
     }
   }
 }
@@ -86,8 +82,8 @@ Add to Cursor Settings > MCP Servers:
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server"
+    "omnisql": {
+      "command": "omnisql-mcp"
     }
   }
 }
@@ -97,17 +93,17 @@ Add to Cursor Settings > MCP Servers:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `DBEAVER_PATH` | Path to DBeaver executable | Auto-detected |
-| `DBEAVER_WORKSPACE` | Path to DBeaver workspace | OS default |
-| `DBEAVER_TIMEOUT` | Query timeout (ms) | `30000` |
-| `DBEAVER_DEBUG` | Enable debug logging | `false` |
-| `DBEAVER_READ_ONLY` | Disable all write operations | `false` |
-| `DBEAVER_ALLOWED_CONNECTIONS` | Comma-separated whitelist of connection IDs or names | All |
-| `DBEAVER_DISABLED_TOOLS` | Comma-separated tools to disable | None |
-| `DBEAVER_POOL_MIN` | Minimum connections per pool | `2` |
-| `DBEAVER_POOL_MAX` | Maximum connections per pool | `10` |
-| `DBEAVER_POOL_IDLE_TIMEOUT` | Idle connection timeout (ms) | `30000` |
-| `DBEAVER_POOL_ACQUIRE_TIMEOUT` | Connection acquire timeout (ms) | `10000` |
+| `OMNISQL_CLI_PATH` | Path to external DB client CLI (used for unsupported-driver fallback) | Unset |
+| `OMNISQL_WORKSPACE` | Path to local DB client workspace directory | OS default |
+| `OMNISQL_TIMEOUT` | Query timeout (ms) | `30000` |
+| `OMNISQL_DEBUG` | Enable debug logging | `false` |
+| `OMNISQL_READ_ONLY` | Disable all write operations | `false` |
+| `OMNISQL_ALLOWED_CONNECTIONS` | Comma-separated whitelist of connection IDs or names | All |
+| `OMNISQL_DISABLED_TOOLS` | Comma-separated tools to disable | None |
+| `OMNISQL_POOL_MIN` | Minimum connections per pool | `2` |
+| `OMNISQL_POOL_MAX` | Maximum connections per pool | `10` |
+| `OMNISQL_POOL_IDLE_TIMEOUT` | Idle connection timeout (ms) | `30000` |
+| `OMNISQL_POOL_ACQUIRE_TIMEOUT` | Connection acquire timeout (ms) | `10000` |
 
 ### Read-Only Mode
 
@@ -116,10 +112,10 @@ Blocks all write operations. The `execute_query` tool only allows SELECT, EXPLAI
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server",
+    "omnisql": {
+      "command": "omnisql-mcp",
       "env": {
-        "DBEAVER_READ_ONLY": "true"
+        "OMNISQL_READ_ONLY": "true"
       }
     }
   }
@@ -128,15 +124,15 @@ Blocks all write operations. The `execute_query` tool only allows SELECT, EXPLAI
 
 ### Connection Whitelist
 
-Restrict which DBeaver connections are visible. Accepts connection IDs or display names, comma-separated:
+Restrict which workspace connections are visible. Accepts connection IDs or display names, comma-separated:
 
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server",
+    "omnisql": {
+      "command": "omnisql-mcp",
       "env": {
-        "DBEAVER_ALLOWED_CONNECTIONS": "dev-postgres,staging-mysql"
+        "OMNISQL_ALLOWED_CONNECTIONS": "dev-postgres,staging-mysql"
       }
     }
   }
@@ -148,10 +144,10 @@ Restrict which DBeaver connections are visible. Accepts connection IDs or displa
 ```json
 {
   "mcpServers": {
-    "dbeaver": {
-      "command": "dbeaver-mcp-server",
+    "omnisql": {
+      "command": "omnisql-mcp",
       "env": {
-        "DBEAVER_DISABLED_TOOLS": "drop_table,alter_table,write_query"
+        "OMNISQL_DISABLED_TOOLS": "drop_table,alter_table,write_query"
       }
     }
   }
@@ -161,7 +157,7 @@ Restrict which DBeaver connections are visible. Accepts connection IDs or displa
 ## Available Tools
 
 ### Connection Management
-- `list_connections` - List all DBeaver connections
+- `list_connections` - List all database connections
 - `get_connection_info` - Get connection details
 - `test_connection` - Test connectivity
 
@@ -197,24 +193,24 @@ Restrict which DBeaver connections are visible. Accepts connection IDs or displa
 
 - **Read-only enforcement**: `execute_query` only accepts read-only statements (SELECT, EXPLAIN, SHOW, DESCRIBE, PRAGMA). Write operations must use `write_query`.
 - **Query validation**: Blocks DROP DATABASE, DROP SCHEMA, TRUNCATE, DELETE/UPDATE without WHERE, GRANT, REVOKE, and user management statements.
-- **Connection whitelist**: Restrict which connections are exposed via `DBEAVER_ALLOWED_CONNECTIONS`.
-- **Tool filtering**: Disable any tool via `DBEAVER_DISABLED_TOOLS`.
+- **Connection whitelist**: Restrict which connections are exposed via `OMNISQL_ALLOWED_CONNECTIONS`.
+- **Tool filtering**: Disable any tool via `OMNISQL_DISABLED_TOOLS`.
 - **Input sanitization**: Connection IDs and SQL identifiers are sanitized to prevent injection.
 - **Recommendation**: For production use, also use a database-level read-only user for defense in depth.
 
-## DBeaver Version Support
+## Workspace Format Support
 
-Supports both configuration formats:
-- DBeaver 6.x: XML config in `.metadata/.plugins/org.jkiss.dbeaver.core/`
-- DBeaver 21.x+: JSON config in `General/.dbeaver/`
+Supports both configuration formats written by DBeaver-compatible DB clients:
+- Legacy: XML config in `.metadata/.plugins/org.jkiss.dbeaver.core/`
+- Modern: JSON config in `General/.dbeaver/`
 
-Credentials are automatically decrypted from DBeaver's `credentials-config.json`.
+Credentials are automatically decrypted from the workspace `credentials-config.json`.
 
 ## Development
 
 ```bash
-git clone https://github.com/srthkdev/dbeaver-mcp-server.git
-cd dbeaver-mcp-server
+git clone https://github.com/srthkdev/omnisql-mcp.git
+cd omnisql-mcp
 npm install
 npm run build
 npm test