@dbx-app/mcp-server 0.4.7 → 0.4.8

package/README.md

@@ -79,16 +79,16 @@ See the [DBX CLI README](../cli/README.md) for command details.
 
 ## Tools
 
-| Tool | Description |
-|---|---|
-| `dbx_list_connections` | List all database connections configured in DBX |
-| `dbx_add_connection` | Add a new database connection |
-| `dbx_remove_connection` | Remove a database connection |
-| `dbx_list_tables` | List tables and views for a connection |
-| `dbx_describe_table` | Get column definitions for a table |
+| Tool                     | Description                                          |
+| ------------------------ | ---------------------------------------------------- |
+| `dbx_list_connections`   | List all database connections configured in DBX      |
+| `dbx_add_connection`     | Add a new database connection                        |
+| `dbx_remove_connection`  | Remove a database connection                         |
+| `dbx_list_tables`        | List tables and views for a connection               |
+| `dbx_describe_table`     | Get column definitions for a table                   |
 | `dbx_get_schema_context` | Get compact table and column context for writing SQL |
-| `dbx_execute_query` | Execute a SQL query (max 100 rows) |
-| `dbx_open_table` | Open a table in DBX desktop app UI |
+| `dbx_execute_query`      | Execute a SQL query (max 100 rows)                   |
+| `dbx_open_table`         | Open a table in DBX desktop app UI                   |
 
 ## SQL Safety
 
@@ -202,16 +202,16 @@ dbx query local "select 1" --json
 
 ### 工具列表
 
-| 工具 | 说明 |
-|---|---|
-| `dbx_list_connections` | 列出 DBX 中所有已配置的数据库连接 |
-| `dbx_add_connection` | 添加新的数据库连接 |
-| `dbx_remove_connection` | 删除数据库连接 |
-| `dbx_list_tables` | 列出指定连接的表和视图 |
-| `dbx_describe_table` | 获取表的列定义 |
+| 工具                     | 说明                                  |
+| ------------------------ | ------------------------------------- |
+| `dbx_list_connections`   | 列出 DBX 中所有已配置的数据库连接     |
+| `dbx_add_connection`     | 添加新的数据库连接                    |
+| `dbx_remove_connection`  | 删除数据库连接                        |
+| `dbx_list_tables`        | 列出指定连接的表和视图                |
+| `dbx_describe_table`     | 获取表的列定义                        |
 | `dbx_get_schema_context` | 获取适合 AI 写 SQL 的紧凑表结构上下文 |
-| `dbx_execute_query` | 执行 SQL 查询（最多返回 100 行） |
-| `dbx_open_table` | 在 DBX 桌面端打开指定表 |
+| `dbx_execute_query`      | 执行 SQL 查询（最多返回 100 行）      |
+| `dbx_open_table`         | 在 DBX 桌面端打开指定表               |
 
 ### SQL 安全
 

package/dist/index.d.ts

@@ -2,7 +2,7 @@
 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, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, doris, starrocks, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, gbase, h2, snowflake, trino, hive, db2, informix, iris, neo4j, cassandra, bigquery, kylin, sundb, tdengine, iotdb, xugu, jdbc, access";
+export declare const DBX_CONNECTION_TYPE_DESCRIPTION = "Database type: postgres, mysql, sqlite, rqlite, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, etcd, doris, starrocks, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, gbase, h2, snowflake, trino, hive, db2, informix, iris, neo4j, cassandra, bigquery, kylin, sundb, tdengine, iotdb, xugu, jdbc, access";
 export declare function createDbxMcpServer(backend: Backend, options?: {
     isWebMode?: boolean;
 }): McpServer;

package/dist/index.js

@@ -23,7 +23,8 @@ function formatQueryToolResult(result, title) {
     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)`);
 }
-export const DBX_CONNECTION_TYPE_DESCRIPTION = "Database type: postgres, mysql, sqlite, rqlite, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, doris, starrocks, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, gbase, h2, snowflake, trino, hive, db2, informix, iris, neo4j, cassandra, bigquery, kylin, sundb, tdengine, iotdb, xugu, jdbc, access";
+export const DBX_CONNECTION_TYPE_DESCRIPTION = "Database type: postgres, mysql, sqlite, rqlite, redis, duckdb, clickhouse, sqlserver, mongodb, oracle, elasticsearch, etcd, doris, starrocks, redshift, dameng, kingbase, highgo, vastbase, goldendb, databend, gaussdb, kwdb, yashandb, databricks, saphana, teradata, vertica, firebird, exasol, opengauss, oceanbase-oracle, gbase, h2, snowflake, trino, hive, db2, informix, iris, neo4j, cassandra, bigquery, kylin, sundb, tdengine, iotdb, xugu, jdbc, access";
+const FILE_CAPABLE_CONNECTION_TYPES = new Set(["sqlite", "duckdb", "access", "h2"]);
 export function createDbxMcpServer(backend, options = {}) {
     const isWebMode = options.isWebMode ?? !!process.env.DBX_WEB_URL;
     const server = new McpServer({
@@ -63,13 +64,7 @@ export function createDbxMcpServer(backend, options = {}) {
         const columns = await backend.describeTable(withDatabase(config, database), table, 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 ?? "",
-        ]);
+        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 text(mdTable(["Column", "Type", "Nullable", "Default", "Comment"], rows));
     });
     server.tool("dbx_execute_query", "Execute a SQL query on a database connection (max 100 rows returned)", {
@@ -95,9 +90,7 @@ export function createDbxMcpServer(backend, options = {}) {
             }
             if (results.length === 1)
                 return formatQueryToolResult(results[0]);
-            return text(results
-                .map((result, index) => formatQueryToolResult(result, `Statement ${index + 1}`).content[0].text)
-                .join("\n\n"));
+            return text(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);
@@ -136,9 +129,14 @@ export function createDbxMcpServer(backend, options = {}) {
         const existing = await backend.findConnection(name);
         if (existing)
             return text(`Connection "${name}" already exists.`);
-        const FILE_BASED_TYPES = new Set(["sqlite", "duckdb", "access"]);
-        const DEFAULT_PORTS = { kwdb: 26257, rqlite: 4001, tdengine: 6041, iotdb: 6667, xugu: 5138 };
-        const resolvedPort = port ?? DEFAULT_PORTS[db_type] ?? (FILE_BASED_TYPES.has(db_type) ? 0 : undefined);
+        const DEFAULT_PORTS = {
+            kwdb: 26257,
+            rqlite: 4001,
+            tdengine: 6041,
+            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({

package/package.json

@@ -1,46 +1,46 @@
 {
   "name": "@dbx-app/mcp-server",
-  "version": "0.4.7",
-  "mcpName": "io.github.t8y2/dbx",
+  "version": "0.4.8",
   "description": "MCP server for DBX — query databases from Claude Code, Cursor, and other AI agents",
-  "type": "module",
-  "engines": {
-    "node": ">=22.13.0"
-  },
-  "bin": {
-    "mcp-server": "dist/index.js",
-    "dbx-mcp-server": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "server.json"
-  ],
   "keywords": [
-    "mcp",
+    "ai-agent",
+    "claude",
     "database",
     "dbx",
-    "claude",
-    "postgresql",
+    "mcp",
     "mysql",
-    "ai-agent"
+    "postgresql"
   ],
+  "homepage": "https://github.com/t8y2/dbx/tree/main/packages/mcp-server",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/t8y2/dbx",
     "directory": "packages/mcp-server"
   },
-  "homepage": "https://github.com/t8y2/dbx/tree/main/packages/mcp-server",
+  "bin": {
+    "dbx-mcp-server": "dist/index.js",
+    "mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "server.json"
+  ],
+  "type": "module",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.25.20",
-    "@dbx-app/node-core": "^0.4.7"
+    "@dbx-app/node-core": "^0.4.8"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3"
   },
+  "engines": {
+    "node": ">=22.13.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",

package/server.json

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