@dbx-app/mcp-server 0.4.32 → 0.4.34

package/README.md

@@ -7,7 +7,7 @@ MCP server for [DBX](https://github.com/t8y2/dbx) — lets AI agents (Claude Cod
 ## Features
 
 - **Zero config** — Automatically reads your DBX connections (including passwords from system keyring)
-- **9 tools** — List/add/remove connections, list tables, describe table, get schema context, execute SQL, execute Redis commands, open table in DBX UI
+- **10 tools** — List/add/remove connections, list tables, describe table, get schema context, execute SQL, execute Redis commands, open tables, and execute-and-show results
 - **Connection pooling** — Reuses database connections across queries
 - **Direct execution** — PostgreSQL, MySQL, SQLite, and compatible databases (Doris, StarRocks, etc.) can run without opening DBX
 - **Writes enabled by default** — regular `INSERT` / `UPDATE` / `DELETE` statements work out of the box, while dangerous SQL stays blocked unless explicitly enabled
@@ -27,6 +27,24 @@ Or run directly:
 npx @dbx-app/mcp-server
 ```
 
+The npm package installs a small Node.js launcher plus a precompiled Rust binary for the current platform. It does not install `better-sqlite3`, compile native modules, or require Rust/Cargo locally. Do not use `--no-optional`, because the platform binary is delivered through npm optional dependencies.
+
+### Offline / native binary
+
+For an offline machine, download the `dbx-mcp` binary matching the operating system and CPU from the DBX release assets, then configure the MCP client to run that file directly:
+
+```json
+{
+  "mcpServers": {
+    "dbx": {
+      "command": "/path/to/dbx-mcp"
+    }
+  }
+}
+```
+
+The native binary works without Node.js and without opening the DBX desktop app for supported direct database connections. Set `DBX_DATA_DIR` when the DBX database is stored outside the default location. `dbx_open_table` and other desktop bridge features still require a running DBX app.
+
 ### 2. Configure Claude Code
 
 Add to your project's `.mcp.json`:
@@ -173,7 +191,8 @@ PostgreSQL, MySQL, SQLite, Doris, StarRocks, and Redshift queries run directly f
 ## Requirements
 
 - [DBX](https://github.com/t8y2/dbx) installed with at least one connection configured
-- Node.js 22.13.0 或更高版本
+- Node.js 18.18.0 or newer (only used by the npm launcher)
+- Rust, Cargo, Python, and native build tools are not required
 
 ## License
 
@@ -272,6 +291,7 @@ dbx query local "select 1" --json
 | `dbx_execute_query`         | 执行 SQL 查询（最多返回 100 行）      |
 | `dbx_execute_redis_command` | 在 Redis 连接上执行 Redis 命令        |
 | `dbx_open_table`            | 在 DBX 桌面端打开指定表               |
+| `dbx_execute_and_show`      | 执行查询并在 DBX 中展示结果           |
 
 ### SQL 安全
 
@@ -330,4 +350,6 @@ PostgreSQL、MySQL、SQLite、Doris、StarRocks、Redshift 查询可由 MCP Serv
 ### 系统要求
 
 - 已安装 [DBX](https://github.com/t8y2/dbx) 并配置了至少一个数据库连接
-- Node.js 22.13.0 or newer
+- Node.js 18.18.0 或更高版本（仅用于 npm 启动器）
+- 不需要安装 Rust、Cargo、Python 或本地编译工具
+- 离线直接运行原生二进制时不需要安装 Node.js

package/bin/dbx-mcp-server.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const platformPackages = {
+  "darwin-arm64": ["@dbx-app/mcp-darwin-arm64", "dbx-mcp"],
+  "darwin-x64": ["@dbx-app/mcp-darwin-x64", "dbx-mcp"],
+  "linux-arm64": ["@dbx-app/mcp-linux-arm64-gnu", "dbx-mcp"],
+  "linux-x64": ["@dbx-app/mcp-linux-x64-gnu", "dbx-mcp"],
+  "win32-arm64": ["@dbx-app/mcp-win32-arm64", "dbx-mcp.exe"],
+  "win32-x64": ["@dbx-app/mcp-win32-x64", "dbx-mcp.exe"],
+};
+
+function resolveBinary() {
+  if (process.env.DBX_MCP_BINARY) {
+    return process.env.DBX_MCP_BINARY;
+  }
+  const platform = `${process.platform}-${process.arch}`;
+  const target = platformPackages[platform];
+  if (!target) {
+    throw new Error(`DBX MCP does not provide a Rust binary for ${platform}.`);
+  }
+  const [packageName, binaryName] = target;
+  let manifest;
+  try {
+    manifest = require.resolve(`${packageName}/package.json`);
+  } catch {
+    throw new Error(
+      `The optional package ${packageName} was not installed. Reinstall @dbx-app/mcp-server without --no-optional.`,
+    );
+  }
+  const binary = join(dirname(manifest), "bin", binaryName);
+  if (!existsSync(binary)) {
+    throw new Error(`The DBX MCP binary is missing from ${packageName}.`);
+  }
+  return binary;
+}
+
+try {
+  if (process.argv[2] === "--verify-platform") {
+    const platform = `${process.platform}-${process.arch}`;
+    if (!platformPackages[platform]) {
+      throw new Error(`DBX MCP does not provide a Rust binary for ${platform}.`);
+    }
+    process.exit(0);
+  }
+  const binary = resolveBinary();
+  const child = spawn(binary, process.argv.slice(2), { stdio: "inherit", env: process.env });
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.on(signal, () => child.kill(signal));
+  }
+  child.on("error", (error) => {
+    console.error(`Failed to start DBX MCP: ${error.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    else process.exit(code ?? 1);
+  });
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbx-app/mcp-server",
-  "version": "0.4.32",
+  "version": "0.4.34",
   "description": "MCP server for DBX — query databases from Claude Code, Cursor, and other AI agents",
   "keywords": [
     "ai-agent",
@@ -19,31 +19,39 @@
     "directory": "packages/mcp-server"
   },
   "bin": {
-    "dbx-mcp-server": "dist/index.js",
-    "mcp-server": "dist/index.js"
+    "dbx-mcp-server": "bin/dbx-mcp-server.js",
+    "mcp-server": "bin/dbx-mcp-server.js"
   },
   "files": [
-    "dist",
+    "bin",
     "server.json"
   ],
   "type": "module",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.25.20",
-    "@dbx-app/node-core": "^0.4.32"
+  "optionalDependencies": {
+    "@dbx-app/mcp-darwin-arm64": "0.4.34",
+    "@dbx-app/mcp-darwin-x64": "0.4.34",
+    "@dbx-app/mcp-linux-arm64-gnu": "0.4.34",
+    "@dbx-app/mcp-linux-x64-gnu": "0.4.34",
+    "@dbx-app/mcp-win32-arm64": "0.4.34",
+    "@dbx-app/mcp-win32-x64": "0.4.34"
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "@types/node": "^22.15.21",
     "tsx": "^4.19.4",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.8",
+    "zod": "^3.25.20",
+    "@dbx-app/node-core": "^0.4.34"
   },
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=18.18.0"
   },
   "mcpName": "io.github.t8y2/dbx",
   "scripts": {
-    "start": "tsx src/index.ts",
-    "test": "pnpm --filter @dbx-app/mcp-server build && vitest run --config vitest.config.ts",
-    "build": "pnpm --filter @dbx-app/node-core build && tsc"
+    "start": "cargo run -p dbx-mcp --",
+    "test": "cargo build -p dbx-mcp && pnpm build:legacy && vitest run --config vitest.config.ts",
+    "build": "pnpm build:legacy",
+    "build:legacy": "pnpm --filter @dbx-app/node-core build && tsc"
   }
 }

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/t8y2/dbx",
     "source": "github"
   },
-  "version": "0.4.32",
+  "version": "0.4.34",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@dbx-app/mcp-server",
-      "version": "0.4.32",
+      "version": "0.4.34",
       "transport": {
         "type": "stdio"
       }

package/dist/index.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { type Backend } from "@dbx-app/node-core";
-export declare const DBX_MCP_PACKAGE_VERSION: string;
-export declare const DBX_CONNECTION_TYPE_DESCRIPTION = "Database type: postgres, mysql, sqlite, rqlite, cloudflare-d1, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, etcd, doris, starrocks, manticoresearch, milvus, qdrant, weaviate, chromadb, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, questdb, gbase, h2, snowflake, trino, prestosql, hive, spark, db2, informix, influxdb, iris, neo4j, cassandra, bigquery, kylin, sundb, oscar, tdengine, iotdb, xugu, zookeeper, jdbc, access, mq";
-export declare function createDbxMcpServer(backend: Backend, options?: {
-    isWebMode?: boolean;
-}): McpServer;

package/dist/index.js

@@ -1,467 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createRequire } from "node:module";
-import { z } from "zod";
-import { buildSchemaContext, createBackend, evaluateRedisCommandSafety, evaluateMongoAggregateSafety, evaluateSqlSafety, formatCell, formatSchemaContext, isMainModule, mdTable, notifyReload, parseMongoAggregateCommand, assessProductionSql, isLikelyMongoMutation, isProductionDatabase, postBridge, logSqlDiagnostic, sqlSafetyFromEnv, splitSqlStatements, supportsHashLineComments, } from "@dbx-app/node-core";
-const require = createRequire(import.meta.url);
-const packageJson = require("../package.json");
-export const DBX_MCP_PACKAGE_VERSION = packageJson.version ?? "0.0.0";
-function text(s) {
-    return { content: [{ type: "text", text: s }] };
-}
-function toolError(code, message) {
-    return { ...text(`${code}: ${message}`), isError: true };
-}
-function withDatabase(config, database) {
-    return database === undefined ? config : { ...config, database };
-}
-function metadataScope(config, database, schema) {
-    if (config.db_type !== "dameng") {
-        return { config: withDatabase(config, database), schema };
-    }
-    // Dameng exposes tables under user-owned schemas rather than separate
-    // databases. Accept the legacy database argument as a schema, and default to
-    // the login user when neither argument is provided.
-    const resolvedSchema = schema?.trim() || database?.trim() || config.username?.trim() || undefined;
-    return { config, schema: resolvedSchema };
-}
-function connectionIdentity(config) {
-    return `${config.name} (${config.id}) [${config.db_type} @ ${config.host}:${config.port}]`;
-}
-function labeledText(config, body) {
-    return text(`[${connectionIdentity(config)}]\n${body}`);
-}
-function formatQueryToolResult(result, title) {
-    const prefix = title ? `${title}\n` : "";
-    if (result.columns.length === 0)
-        return text(`${prefix}Query executed. ${result.row_count} row(s) affected.`);
-    const rows = result.rows.map((r) => result.columns.map((c) => formatCell(r[c])));
-    return text(`${prefix}${mdTable(result.columns, rows)}\n\n${result.row_count} row(s)`);
-}
-function redisDbFromValue(value) {
-    const trimmed = value?.trim();
-    if (!trimmed)
-        return undefined;
-    const db = Number(trimmed);
-    return Number.isInteger(db) && db >= 0 ? db : undefined;
-}
-function defaultRedisDb(config, scope, db) {
-    return db ?? redisDbFromValue(scope.database) ?? redisDbFromValue(config.database) ?? 0;
-}
-function formatRedisCommandValue(value) {
-    if (typeof value === "string")
-        return value;
-    return JSON.stringify(value, null, 2) ?? String(value);
-}
-function formatRedisCommandToolResult(result) {
-    return text(`Command: ${result.command}\nSafety: ${result.safety}\n\n${formatRedisCommandValue(result.value)}`);
-}
-export const DBX_CONNECTION_TYPE_DESCRIPTION = "Database type: postgres, mysql, sqlite, rqlite, cloudflare-d1, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, etcd, doris, starrocks, manticoresearch, milvus, qdrant, weaviate, chromadb, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, questdb, gbase, h2, snowflake, trino, prestosql, hive, spark, db2, informix, influxdb, iris, neo4j, cassandra, bigquery, kylin, sundb, oscar, tdengine, iotdb, xugu, zookeeper, jdbc, access, mq";
-const FILE_CAPABLE_CONNECTION_TYPES = new Set(["sqlite", "duckdb", "access", "h2"]);
-function scopedValue(value) {
-    const trimmed = value?.trim();
-    return trimmed ? trimmed : undefined;
-}
-function mcpScopeFromEnv() {
-    return {
-        connectionId: scopedValue(process.env.DBX_MCP_SCOPE_CONNECTION_ID),
-        connectionName: scopedValue(process.env.DBX_MCP_SCOPE_CONNECTION_NAME),
-        database: scopedValue(process.env.DBX_MCP_SCOPE_DATABASE),
-    };
-}
-function scopeEnabled(scope) {
-    return !!(scope.connectionId || scope.connectionName);
-}
-function connectionMatchesScope(config, scope) {
-    return (!!scope.connectionId && config.id === scope.connectionId) || (!!scope.connectionName && config.name === scope.connectionName);
-}
-async function loadScopedConnections(backend, scope) {
-    const connections = await backend.loadConnections();
-    if (!scopeEnabled(scope))
-        return connections;
-    return connections.filter((config) => connectionMatchesScope(config, scope));
-}
-async function resolveConnection(backend, scope, requestedId, requestedName) {
-    // connection_id takes priority over connection_name when both are provided.
-    if (requestedId?.trim()) {
-        const connections = await backend.loadConnections();
-        const config = connections.find((c) => c.id === requestedId.trim());
-        if (!config)
-            return { error: toolError("CONNECTION_NOT_FOUND", `Connection with id "${requestedId}" not found.`) };
-        // In scoped mode, verify the resolved connection is within the scope.
-        if (scopeEnabled(scope) && !connectionMatchesScope(config, scope)) {
-            return { error: toolError("CONNECTION_OUT_OF_SCOPE", `Connection "${requestedId}" is outside this DBX AI session scope.`) };
-        }
-        return { config };
-    }
-    if (!scopeEnabled(scope)) {
-        if (!requestedName?.trim())
-            return { error: toolError("CONNECTION_NOT_FOUND", "Connection name is required.") };
-        const connections = await backend.loadConnections();
-        const matching = connections.filter((c) => c.name.toLowerCase() === requestedName.trim().toLowerCase());
-        if (matching.length === 0)
-            return { error: toolError("CONNECTION_NOT_FOUND", `Connection "${requestedName}" not found.`) };
-        if (matching.length > 1) {
-            const lines = matching.map((c) => `- ${c.id}: ${c.db_type} @ ${c.host}:${c.port}`);
-            return {
-                error: toolError("AMBIGUOUS_CONNECTION", `Multiple connections found with name "${requestedName}". Please specify connection_id:\n${lines.join("\n")}`),
-            };
-        }
-        return { config: matching[0] };
-    }
-    const [scopedConfig] = await loadScopedConnections(backend, scope);
-    if (!scopedConfig)
-        return { error: toolError("CONNECTION_NOT_FOUND", "Scoped DBX connection was not found.") };
-    if (requestedName?.trim() && requestedName !== scopedConfig.name && requestedName !== scopedConfig.id) {
-        return { error: toolError("CONNECTION_OUT_OF_SCOPE", `Connection "${requestedName}" is outside this DBX AI session scope.`) };
-    }
-    return { config: scopedConfig };
-}
-export function createDbxMcpServer(backend, options = {}) {
-    const isWebMode = options.isWebMode ?? !!process.env.DBX_WEB_URL;
-    const scope = mcpScopeFromEnv();
-    const scoped = scopeEnabled(scope);
-    const server = new McpServer({
-        name: "dbx",
-        version: DBX_MCP_PACKAGE_VERSION,
-    });
-    server.tool("dbx_list_connections", "List all database connections configured in DBX", {}, async () => {
-        const connections = await loadScopedConnections(backend, scope);
-        if (connections.length === 0)
-            return text("No connections configured in DBX.");
-        const rows = connections.map((c) => [c.id, c.name, c.db_type, c.host, String(c.port), c.database || ""]);
-        return text(mdTable(["ID", "Name", "Type", "Host", "Port", "Database"], rows));
-    });
-    server.tool("dbx_list_tables", "List tables and views for a database connection", {
-        connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-        connection_name: z.string().optional().describe("Name of the DBX connection"),
-        database: z.string().optional().describe("Database name; for Dameng this is also accepted as a schema alias"),
-        schema: z.string().optional().describe("Schema name (default: public for PostgreSQL, login user for Dameng)"),
-    }, async ({ connection_id, connection_name, database, schema }) => {
-        const { config, error } = await resolveConnection(backend, scope, connection_id, connection_name);
-        if (error)
-            return error;
-        const resolvedConfig = config;
-        const scopeValue = metadataScope(resolvedConfig, database ?? scope.database, schema);
-        const tables = await backend.listTables(scopeValue.config, scopeValue.schema);
-        if (tables.length === 0)
-            return text("No tables found.");
-        const rows = tables.map((t) => [t.name, t.type]);
-        return labeledText(resolvedConfig, mdTable(["Table", "Type"], rows));
-    });
-    server.tool("dbx_describe_table", "Get column definitions for a table", {
-        connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-        connection_name: z.string().optional().describe("Name of the DBX connection"),
-        table: z.string().describe("Table name"),
-        database: z.string().optional().describe("Database name; for Dameng this is also accepted as a schema alias"),
-        schema: z.string().optional().describe("Schema name (default: public for PostgreSQL, login user for Dameng)"),
-    }, async ({ connection_id, connection_name, table, database, schema }) => {
-        const { config, error } = await resolveConnection(backend, scope, connection_id, connection_name);
-        if (error)
-            return error;
-        const resolvedConfig = config;
-        const scopeValue = metadataScope(resolvedConfig, database ?? scope.database, schema);
-        const columns = await backend.describeTable(scopeValue.config, table, scopeValue.schema);
-        if (columns.length === 0)
-            return text("No columns found.");
-        const rows = columns.map((c) => [c.is_primary_key ? `${c.name} (PK)` : c.name, c.data_type, c.is_nullable ? "YES" : "NO", c.column_default ?? "", c.comment ?? ""]);
-        return labeledText(resolvedConfig, mdTable(["Column", "Type", "Nullable", "Default", "Comment"], rows));
-    });
-    server.tool("dbx_execute_query", "Execute a SQL query on a database connection (max 100 rows returned)", {
-        connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-        connection_name: z.string().optional().describe("Name of the DBX connection"),
-        database: z.string().optional().describe("Database name"),
-        sql: z.string().describe("SQL query to execute"),
-    }, async ({ connection_id, connection_name, database, sql }) => {
-        logSqlDiagnostic("dbx_execute_query", sql, { connection_id, connection_name, database });
-        const { config, error } = await resolveConnection(backend, scope, connection_id, connection_name);
-        if (error)
-            return error;
-        const scopedConfig = config;
-        if (scopedConfig.db_type === "redis") {
-            return toolError("REDIS_COMMAND_REQUIRED", "Redis connections do not accept SQL through dbx_execute_query. Use dbx_execute_redis_command with a Redis command such as GET key or INFO.");
-        }
-        if (scopedConfig.db_type !== "mongodb") {
-            const hashLineComments = supportsHashLineComments(scopedConfig.db_type);
-            const safety = evaluateSqlSafety(sql, { ...sqlSafetyFromEnv(), allowMultipleStatements: true, hashLineComments });
-            if (!safety.allowed)
-                return toolError("SQL_BLOCKED", safety.reason ?? "SQL blocked.");
-            const production = assessProductionSql(sql, scopedConfig, database ?? scope.database ?? scopedConfig.database);
-            if (production.active && production.isMutation) {
-                return toolError("PRODUCTION_WRITE_BLOCKED", "MCP cannot execute writes against a production database. Return the SQL for a user to review and run in DBX.");
-            }
-        }
-        else if (isProductionDatabase(scopedConfig, database ?? scope.database ?? scopedConfig.database) && isLikelyMongoMutation(sql)) {
-            return toolError("PRODUCTION_WRITE_BLOCKED", "MCP cannot execute writes against a production database. Return the command for a user to review and run in DBX.");
-        }
-        // MongoDB shell commands don't fit the SQL safety evaluator; the backend
-        // (node-core executeQuery) applies command-aware read/write gating.
-        try {
-            const statements = scopedConfig.db_type === "mongodb" ? [sql] : splitSqlStatements(sql, { hashLineComments: supportsHashLineComments(scopedConfig.db_type) });
-            const results = [];
-            for (const statement of statements) {
-                results.push(await backend.executeQuery(withDatabase(scopedConfig, database ?? scope.database), statement));
-            }
-            if (results.length === 1)
-                return labeledText(scopedConfig, formatQueryToolResult(results[0]).content[0].text);
-            return labeledText(scopedConfig, results.map((result, index) => formatQueryToolResult(result, `Statement ${index + 1}`).content[0].text).join("\n\n"));
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            return toolError("QUERY_ERROR", msg);
-        }
-    });
-    server.tool("dbx_execute_redis_command", "Execute a Redis command on a Redis connection", {
-        connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-        connection_name: z.string().optional().describe("Name of the DBX Redis connection"),
-        db: z.number().int().min(0).optional().describe("Redis logical database number (default: scoped/default database or 0)"),
-        command: z.string().describe("Redis command to execute, for example: GET mykey, INFO, or DBSIZE"),
-    }, async ({ connection_id, connection_name, db, command }) => {
-        const { config, error } = await resolveConnection(backend, scope, connection_id, connection_name);
-        if (error)
-            return error;
-        const scopedConfig = config;
-        if (scopedConfig.db_type !== "redis") {
-            return toolError("INVALID_CONNECTION_TYPE", `Connection "${scopedConfig.name}" is ${scopedConfig.db_type}, not Redis.`);
-        }
-        if (!backend.executeRedisCommand) {
-            return toolError("UNSUPPORTED_BACKEND", "This DBX backend does not support Redis command execution.");
-        }
-        const safety = evaluateRedisCommandSafety(command, sqlSafetyFromEnv());
-        if (!safety.allowed)
-            return toolError("REDIS_COMMAND_BLOCKED", safety.reason ?? "Redis command blocked.");
-        if (isProductionDatabase(scopedConfig, String(defaultRedisDb(scopedConfig, scope, db))) && safety.safety !== "allowed") {
-            return toolError("PRODUCTION_WRITE_BLOCKED", "MCP cannot execute write or dangerous Redis commands against a production database.");
-        }
-        try {
-            const result = await backend.executeRedisCommand(scopedConfig, defaultRedisDb(scopedConfig, scope, db), command, {
-                skipSafetyCheck: safety.skipSafetyCheck,
-            });
-            return labeledText(scopedConfig, formatRedisCommandToolResult(result).content[0].text);
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            return toolError("REDIS_COMMAND_ERROR", msg);
-        }
-    });
-    server.tool("dbx_get_schema_context", "Get compact table and column context for writing SQL", {
-        connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-        connection_name: z.string().optional().describe("Name of the DBX connection"),
-        database: z.string().optional().describe("Database name"),
-        schema: z.string().optional().describe("Schema name (default: public for PostgreSQL)"),
-        tables: z.array(z.string()).optional().describe("Specific table names to include"),
-        max_tables: z.number().int().min(1).max(20).default(8).describe("Maximum number of tables to include"),
-    }, async ({ connection_id, connection_name, database, schema, tables, max_tables }) => {
-        const { config, error } = await resolveConnection(backend, scope, connection_id, connection_name);
-        if (error)
-            return error;
-        const resolvedConfig = config;
-        const context = await buildSchemaContext(backend, withDatabase(resolvedConfig, database ?? scope.database), {
-            schema,
-            tables,
-            maxTables: max_tables,
-        });
-        if (context.tables.length === 0)
-            return text("No matching tables found.");
-        return labeledText(resolvedConfig, formatSchemaContext(context));
-    });
-    if (!scoped) {
-        server.tool("dbx_add_connection", "Add a new database connection to DBX", {
-            name: z.string().describe("Connection name"),
-            db_type: z.string().describe(DBX_CONNECTION_TYPE_DESCRIPTION),
-            host: z.string().describe("Database host; for cloudflare-d1, use the Cloudflare Account ID"),
-            port: z.number().optional().describe("Database port (TDengine defaults to 6041, IoTDB defaults to 6667, XuguDB defaults to 5138)"),
-            username: z.string().default("").describe("Username"),
-            password: z.string().default("").describe("Password; for cloudflare-d1, use the API Token"),
-            database: z.string().optional().describe("Default database name; for cloudflare-d1, use the D1 Database ID"),
-            ssl: z.boolean().default(false).describe("Enable SSL"),
-            driver_profile: z.string().optional().describe("Driver profile (e.g. 'gbase8a', 'gbase8s')"),
-        }, async ({ name, db_type, host, port, username, password, database, ssl, driver_profile }) => {
-            const existing = await backend.findConnection(name);
-            if (existing)
-                return text(`Connection "${name}" already exists.`);
-            const DEFAULT_PORTS = {
-                kwdb: 26257,
-                rqlite: 4001,
-                "cloudflare-d1": 443,
-                tdengine: 6041,
-                oscar: 2003,
-                iotdb: 6667,
-                xugu: 5138,
-            };
-            const resolvedPort = port ?? DEFAULT_PORTS[db_type] ?? (FILE_CAPABLE_CONNECTION_TYPES.has(db_type) ? 0 : undefined);
-            if (resolvedPort === undefined)
-                return text("Port is required for this database type.");
-            const config = await backend.addConnection({
-                name,
-                db_type,
-                host,
-                port: resolvedPort,
-                username,
-                password,
-                database,
-                ssl,
-                driver_profile,
-                ssh_enabled: false,
-            });
-            await notifyReload();
-            return text(`Connection "${config.name}" added (id: ${config.id}).`);
-        });
-        server.tool("dbx_remove_connection", "Remove a database connection from DBX", {
-            connection_name: z.string().describe("Name of the connection to remove"),
-            connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to remove by id instead of name)"),
-        }, async ({ connection_name, connection_id }) => {
-            if (connection_id?.trim()) {
-                if (backend.removeConnectionById) {
-                    const removed = await backend.removeConnectionById(connection_id.trim());
-                    if (!removed)
-                        return toolError("CONNECTION_NOT_FOUND", `Connection with id "${connection_id}" not found.`);
-                    await notifyReload();
-                    return text(`Connection with id "${connection_id}" removed.`);
-                }
-                // Fallback: resolve by id then remove by name
-                const connections = await backend.loadConnections();
-                const config = connections.find((c) => c.id === connection_id.trim());
-                if (!config)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection with id "${connection_id}" not found.`);
-                const removed = await backend.removeConnection(config.name);
-                if (!removed)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection "${config.name}" could not be removed.`);
-                await notifyReload();
-                return text(`Connection "${config.name}" (id: ${config.id}) removed.`);
-            }
-            const allConnections = await backend.loadConnections();
-            const matching = allConnections.filter((c) => c.name.toLowerCase() === connection_name.toLowerCase());
-            if (matching.length === 0)
-                return toolError("CONNECTION_NOT_FOUND", `Connection "${connection_name}" not found.`);
-            if (matching.length > 1) {
-                const lines = matching.map((c) => `- ${c.id}: ${c.db_type} @ ${c.host}:${c.port}`);
-                return toolError("AMBIGUOUS_CONNECTION", `Multiple connections found with name "${connection_name}". Please specify connection_id:\n${lines.join("\n")}`);
-            }
-            const removed = await backend.removeConnection(connection_name);
-            if (!removed)
-                return toolError("CONNECTION_NOT_FOUND", `Connection "${connection_name}" not found.`);
-            await notifyReload();
-            return text(`Connection "${connection_name}" removed.`);
-        });
-    }
-    // Desktop-only tools: open table and execute-and-show require the Tauri bridge
-    if (!isWebMode && !scoped) {
-        server.tool("dbx_open_table", "Open a table in DBX desktop app UI. Requires DBX to be running.", {
-            connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-            connection_name: z.string().optional().describe("Name of the DBX connection"),
-            table: z.string().describe("Table name to open"),
-            database: z.string().optional().describe("Database name"),
-            schema: z.string().optional().describe("Schema name"),
-        }, async ({ connection_id, connection_name, table, database, schema }) => {
-            let config;
-            if (connection_id?.trim()) {
-                const connections = await backend.loadConnections();
-                config = connections.find((c) => c.id === connection_id.trim());
-                if (!config)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection with id "${connection_id}" not found.`);
-            }
-            else if (connection_name?.trim()) {
-                const connections = await backend.loadConnections();
-                const matching = connections.filter((c) => c.name.toLowerCase() === connection_name.toLowerCase());
-                if (matching.length === 0)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection "${connection_name}" not found.`);
-                if (matching.length > 1) {
-                    const lines = matching.map((c) => `- ${c.id}: ${c.db_type} @ ${c.host}:${c.port}`);
-                    return toolError("AMBIGUOUS_CONNECTION", `Multiple connections found with name "${connection_name}". Please specify connection_id:\n${lines.join("\n")}`);
-                }
-                config = matching[0];
-            }
-            else {
-                return toolError("CONNECTION_NOT_FOUND", "Either connection_id or connection_name is required.");
-            }
-            return bridgeRequest("/open-table", { connection_id: config.id, connection_name: config.name, table, database, schema }, `Opened ${table} in DBX`);
-        });
-        server.tool("dbx_execute_and_show", "Execute a SQL query in DBX desktop app UI and show results there. Requires DBX to be running.", {
-            connection_id: z.string().optional().describe("Unique ID of the DBX connection (use this to disambiguate when multiple connections share the same name)"),
-            connection_name: z.string().optional().describe("Name of the DBX connection"),
-            sql: z.string().describe("SQL query to execute"),
-            database: z.string().optional().describe("Database name"),
-        }, async ({ connection_id, connection_name, sql, database }) => {
-            let config;
-            if (connection_id?.trim()) {
-                const connections = await backend.loadConnections();
-                config = connections.find((c) => c.id === connection_id.trim());
-                if (!config)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection with id "${connection_id}" not found.`);
-            }
-            else if (connection_name?.trim()) {
-                const connections = await backend.loadConnections();
-                const matching = connections.filter((c) => c.name.toLowerCase() === connection_name.toLowerCase());
-                if (matching.length === 0)
-                    return toolError("CONNECTION_NOT_FOUND", `Connection "${connection_name}" not found.`);
-                if (matching.length > 1) {
-                    const lines = matching.map((c) => `- ${c.id}: ${c.db_type} @ ${c.host}:${c.port}`);
-                    return toolError("AMBIGUOUS_CONNECTION", `Multiple connections found with name "${connection_name}". Please specify connection_id:\n${lines.join("\n")}`);
-                }
-                config = matching[0];
-            }
-            else {
-                return toolError("CONNECTION_NOT_FOUND", "Either connection_id or connection_name is required.");
-            }
-            const safetyOptions = sqlSafetyFromEnv();
-            if (config?.db_type === "mongodb") {
-                const aggregate = parseMongoAggregateCommand(sql);
-                if (aggregate) {
-                    const safety = evaluateMongoAggregateSafety(aggregate, safetyOptions);
-                    if (!safety.allowed)
-                        return toolError("SQL_BLOCKED", safety.reason ?? "Query blocked.");
-                }
-            }
-            else {
-                const hashLineComments = supportsHashLineComments(config?.db_type);
-                const safety = evaluateSqlSafety(sql, { ...safetyOptions, allowMultipleStatements: true, hashLineComments });
-                if (!safety.allowed)
-                    return toolError("SQL_BLOCKED", safety.reason ?? "SQL blocked.");
-            }
-            if (config?.db_type === "mongodb") {
-                if (isProductionDatabase(config, database ?? scope.database ?? config.database) && isLikelyMongoMutation(sql)) {
-                    return toolError("PRODUCTION_WRITE_BLOCKED", "MCP cannot send writes against a production database to DBX.");
-                }
-            }
-            else {
-                const production = assessProductionSql(sql, config, database ?? scope.database ?? config.database);
-                if (production.active && production.isMutation) {
-                    return toolError("PRODUCTION_WRITE_BLOCKED", "MCP cannot send writes against a production database to DBX.");
-                }
-            }
-            // MongoDB shell commands bypass the SQL safety evaluator; pass MCP
-            // safety flags to the desktop executor for command-aware gating.
-            logSqlDiagnostic("dbx_execute_in_app", sql, { connection_id: config.id, connection_name: config.name, database });
-            return bridgeRequest("/execute-query", {
-                connection_id: config.id,
-                connection_name: config.name,
-                sql,
-                database,
-                allow_writes: safetyOptions.allowWrites,
-                allow_dangerous: safetyOptions.allowDangerous,
-            }, "Query sent to DBX");
-        });
-    }
-    return server;
-}
-async function bridgeRequest(path, body, successMsg) {
-    const res = await postBridge(path, body);
-    if (res.ok)
-        return text(successMsg);
-    const message = res.text.startsWith("DBX is not running") ? res.text : `Failed: ${res.text}`;
-    return toolError("DBX_NOT_RUNNING", message);
-}
-async function main() {
-    const backend = await createBackend();
-    const server = createDbxMcpServer(backend);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-if (isMainModule(import.meta.url, process.argv[1])) {
-    main().catch((e) => {
-        console.error("MCP Server failed to start:", e);
-        process.exit(1);
-    });
-}