@xingyuchen/mysql-mcp-server 4.0.6 → 4.0.7

package/dist/index.js

@@ -72,7 +72,7 @@ async function initializeDatabaseConnections(dbManager, configs) {
 function createMCPServer(dbManager) {
     const server = new Server({
         name: "mysql-mcp-server",
-        version: "4.0.6"
+        version: "4.0.7"
     }, {
         capabilities: {
             tools: {}
@@ -136,7 +136,7 @@ app.get("/health", (_req, res) => {
         status: "healthy",
         transport: "streamable-http",
         activeSessions: sessions.size,
-        version: "4.0.6"
+        version: "4.0.7"
     });
 });
 // ==================== MCP Endpoint ====================

package/dist/tools/connection.js

@@ -39,7 +39,7 @@ export const connectionTools = [
     },
     {
         name: "list_connections",
-        description: "列出所有数据库连接",
+        description: "列出所有数据库连接及其ID。如果需要知道有效的connection_id，请调用此工具查看。返回信息包括：连接ID、主机、端口、数据库名、当前活跃状态等。",
         inputSchema: {
             type: "object",
             properties: {},

package/dist/tools/query.js

@@ -4,7 +4,7 @@
 export const queryTools = [
     {
         name: "execute_query",
-        description: "执行SQL查询（支持SELECT、INSERT、UPDATE、DELETE等所有SQL语句）",
+        description: "执行SQL查询（支持SELECT、INSERT、UPDATE、DELETE等所有SQL语句）。注意：通常不需要指定connection_id，系统会自动使用当前活跃连接。",
         inputSchema: {
             type: "object",
             properties: {
@@ -14,7 +14,7 @@ export const queryTools = [
                 },
                 connection_id: {
                     type: "string",
-                    description: "指定连接ID（可选，不指定则使用当前活跃连接）"
+                    description: "【通常不需要填写】指定连接ID。留空则自动使用当前活跃连接。如需查看可用连接ID，请先调用 list_connections 工具。"
                 }
             },
             required: ["query"]
@@ -22,13 +22,13 @@ export const queryTools = [
     },
     {
         name: "show_tables",
-        description: "显示数据库中的所有表",
+        description: "显示数据库中的所有表。自动使用当前活跃的数据库连接。",
         inputSchema: {
             type: "object",
             properties: {
                 connection_id: {
                     type: "string",
-                    description: "指定连接ID（可选）"
+                    description: "【通常不需要填写】指定连接ID，留空自动使用活跃连接"
                 }
             },
             required: []
@@ -36,7 +36,7 @@ export const queryTools = [
     },
     {
         name: "describe_table",
-        description: "查看表的结构和字段信息",
+        description: "查看表的结构和字段信息。自动使用当前活跃的数据库连接。",
         inputSchema: {
             type: "object",
             properties: {
@@ -46,7 +46,7 @@ export const queryTools = [
                 },
                 connection_id: {
                     type: "string",
-                    description: "指定连接ID（可选）"
+                    description: "【通常不需要填写】指定连接ID，留空自动使用活跃连接"
                 }
             },
             required: ["table_name"]
@@ -54,24 +54,53 @@ export const queryTools = [
     },
     {
         name: "show_databases",
-        description: "显示所有可访问的数据库",
+        description: "显示所有可访问的数据库。自动使用当前活跃的数据库连接。",
         inputSchema: {
             type: "object",
             properties: {
                 connection_id: {
                     type: "string",
-                    description: "指定连接ID（可选）"
+                    description: "【通常不需要填写】指定连接ID，留空自动使用活跃连接"
                 }
             },
             required: []
         }
     }
 ];
+/**
+ * 验证并规范化 connection_id 参数
+ * 如果传入无效值（空字符串、"默认"、"default" 等），返回 undefined 使用活跃连接
+ */
+function normalizeConnectionId(connectionId, dbManager) {
+    // 如果未提供或为空，使用活跃连接
+    if (!connectionId || connectionId.trim() === '') {
+        return undefined;
+    }
+    const trimmed = connectionId.trim();
+    // 常见的无效值列表（AI 可能会传这些）
+    const invalidValues = [
+        '默认', 'default', 'active', 'current', 'auto',
+        '当前', '活跃', 'none', 'null', 'undefined'
+    ];
+    if (invalidValues.includes(trimmed.toLowerCase())) {
+        return undefined;
+    }
+    // 检查连接是否真实存在
+    const connections = dbManager.listConnections();
+    const exists = connections.some(conn => conn.id === trimmed);
+    if (!exists) {
+        // 连接不存在，回退到活跃连接
+        console.log(`⚠️ connection_id "${trimmed}" 不存在，使用活跃连接`);
+        return undefined;
+    }
+    return trimmed;
+}
 /**
  * 查询工具处理器
  */
 export async function handleQueryTool(name, args, dbManager) {
-    const { connection_id } = args;
+    // 规范化 connection_id，无效值自动回退到活跃连接
+    const connection_id = normalizeConnectionId(args.connection_id, dbManager);
     switch (name) {
         case "execute_query": {
             const { query } = args;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingyuchen/mysql-mcp-server",
-  "version": "4.0.6",
+  "version": "4.0.7",
   "type": "module",
   "main": "dist/index.js",
   "bin": {