@xingyuchen/mysql-mcp-server 4.0.4 → 4.0.5

package/README.md

@@ -321,10 +321,33 @@ lsof -ti:3001 | xargs kill -9
 
 **解决：** 刷新 MCP 客户端（重新初始化）
 
+### 4. 连接已关闭错误
+
+**错误：** `Can't add new command when connection is in closed state`
+
+**原因：** 
+- 数据库连接长时间空闲，MySQL 服务器关闭了连接
+- 网络中断导致连接断开
+
+**解决方案：** 
+- ✅ v4.0.5+ 已使用连接池替代单连接，自动支持：
+  - 连接保活（Keep-Alive）机制
+  - 自动重连功能
+  - 并发查询支持
+- 如果仍遇到问题，请重启 MCP 服务器
+
 ---
 
 ## 📦 版本历史
 
+### v4.0.5 (2025-12-09) - 连接池优化
+
+- 🎯 使用连接池替代单连接
+- 🔄 自动连接保活（Keep-Alive）
+- 🔌 自动重连机制
+- 🚀 支持并发查询
+- 🐛 修复 "connection in closed state" 错误
+
 ### v4.0.0 (2025-12-09) - 全新架构
 
 - 🔥 完全重写，全新模块化架构
@@ -349,6 +372,114 @@ lsof -ti:3001 | xargs kill -9
 
 ---
 
+## 🔧 故障排除
+
+### 问题：`ERR_MODULE_NOT_FOUND` 错误
+
+**错误信息**：
+```
+Error [ERR_MODULE_NOT_FOUND]: Cannot find module '...@modelcontextprotocol/sdk...'
+```
+
+**解决方案**：
+
+1. **删除并重新安装依赖**：
+```bash
+# 删除旧依赖
+rm -rf node_modules package-lock.json  # Linux/Mac
+# 或
+rmdir /s /q node_modules && del package-lock.json  # Windows
+
+# 清理缓存
+npm cache clean --force
+
+# 重新安装
+npm install
+```
+
+2. **检查 Node.js 版本**：
+```bash
+node --version  # 需要 >= 18.0.0
+```
+
+3. **使用全局安装**：
+```bash
+npm install -g @xingyuchen/mysql-mcp-server@latest
+```
+
+### 问题：SSE 流断开
+
+**错误信息**：
+```
+SSE stream disconnected: TypeError: terminated
+```
+
+**解决方案**：
+
+在 `mcp.json` 中设置更长的超时或禁用超时：
+```json
+{
+  "mysql-mcp-http": {
+    "type": "streamableHttp",
+    "url": "http://localhost:3002/mcp",
+    "timeout": 0,  // 0 表示无超时限制
+    "headers": { ... }
+  }
+}
+```
+
+### 问题：安全漏洞警告
+
+**警告信息**：
+```
+npm audit: vulnerabilities found
+```
+
+**解决方案**：
+```bash
+# 自动修复
+npm audit fix
+
+# 如果还有问题，强制修复
+npm audit fix --force
+
+# 重新构建
+npm run build
+```
+
+### 问题：端口被占用
+
+**错误信息**：
+```
+Error: listen EADDRINUSE: address already in use :::3002
+```
+
+**解决方案**：
+
+1. **更改端口**（在 `.env` 文件中）：
+```env
+PORT=3003
+```
+
+2. **或者关闭占用端口的进程**：
+```bash
+# Windows
+netstat -ano | findstr :3002
+taskkill /PID <进程ID> /F
+
+# Linux/Mac
+lsof -i :3002
+kill -9 <进程ID>
+```
+
+### 获取更多帮助
+
+- 🐛 [提交 Issue](https://github.com/guangxiangdebizi/MySQL_MCP/issues)
+- 📖 [查看文档](https://github.com/guangxiangdebizi/MySQL_MCP#readme)
+- 💬 [讨论区](https://github.com/guangxiangdebizi/MySQL_MCP/discussions)
+
+---
+
 ## 📄 License
 
 Apache 2.0 License - 详见 [LICENSE](./LICENSE) 文件

package/dist/database.js

@@ -11,8 +11,8 @@ export class DatabaseConnectionManager {
         if (this.connections.has(config.id)) {
             await this.removeConnection(config.id);
         }
-        // 创建连接
-        const connection = await mysql.createConnection({
+        // 创建连接池
+        const pool = mysql.createPool({
             host: config.host,
             port: config.port,
             user: config.user,
@@ -20,11 +20,25 @@ export class DatabaseConnectionManager {
             database: config.database,
             charset: 'utf8mb4',
             timezone: '+08:00',
+            // 连接池配置
+            waitForConnections: true,
+            connectionLimit: 10,
+            queueLimit: 0,
+            // 连接保活配置
+            enableKeepAlive: true,
+            keepAliveInitialDelay: 0,
+            // 超时配置
+            connectTimeout: 10000,
+            // 自动重连
+            maxIdle: 10,
+            idleTimeout: 60000,
         });
         // 测试连接
+        const connection = await pool.getConnection();
         await connection.ping();
-        // 保存连接和配置
-        this.connections.set(config.id, connection);
+        connection.release();
+        // 保存连接池和配置
+        this.connections.set(config.id, pool);
         this.configs.set(config.id, {
             ...config,
             isActive: false,
@@ -40,11 +54,11 @@ export class DatabaseConnectionManager {
      * 移除连接
      */
     async removeConnection(id) {
-        const connection = this.connections.get(id);
-        if (!connection) {
+        const pool = this.connections.get(id);
+        if (!pool) {
             throw new Error(`连接 '${id}' 不存在`);
         }
-        await connection.end();
+        await pool.end();
         this.connections.delete(id);
         this.configs.delete(id);
         // 如果移除的是活跃连接，切换到第一个可用连接
@@ -65,7 +79,7 @@ export class DatabaseConnectionManager {
         console.log(`🎯 已选择数据库: ${id}`);
     }
     /**
-     * 获取活跃连接
+     * 获取活跃连接池
      */
     getActiveConnection() {
         if (!this.activeConnectionId || !this.connections.has(this.activeConnectionId)) {
@@ -80,7 +94,7 @@ export class DatabaseConnectionManager {
         return this.activeConnectionId;
     }
     /**
-     * 获取指定连接
+     * 获取指定连接池
      */
     getConnection(id) {
         return this.connections.get(id);
@@ -98,23 +112,23 @@ export class DatabaseConnectionManager {
      * 执行查询
      */
     async executeQuery(sql, connectionId) {
-        const connection = connectionId
+        const pool = connectionId
             ? this.getConnection(connectionId)
             : this.getActiveConnection();
-        if (!connection) {
+        if (!pool) {
             throw new Error(connectionId ? `连接 '${connectionId}' 不存在` : "没有活跃连接");
         }
-        const [results] = await connection.query(sql);
+        const [results] = await pool.query(sql);
         return results;
     }
     /**
-     * 断开所有连接
+     * 断开所有连接池
      */
     async disconnectAll() {
-        for (const [id, connection] of this.connections.entries()) {
+        for (const [id, pool] of this.connections.entries()) {
             try {
-                await connection.end();
-                console.log(`断开连接: ${id}`);
+                await pool.end();
+                console.log(`断开连接池: ${id}`);
             }
             catch (error) {
                 console.error(`断开 ${id} 失败:`, error);

package/dist/index.js

@@ -55,7 +55,7 @@ function extractDatabaseConfigsFromHeaders(req) {
 function createMCPServer(dbManager) {
     const server = new Server({
         name: "mysql-mcp-server",
-        version: "4.0.4"
+        version: "4.0.5"
     }, {
         capabilities: {
             tools: {}
@@ -119,7 +119,7 @@ app.get("/health", (_req, res) => {
         status: "healthy",
         transport: "streamable-http",
         activeSessions: sessions.size,
-        version: "4.0.0"
+        version: "4.0.5"
     });
 });
 // ==================== MCP Endpoint ====================
@@ -301,7 +301,7 @@ app.listen(PORT, () => {
     console.log(`
 ╔═══════════════════════════════════════════════════════════╗
 ║                                                           ║
-║   🚀 MySQL MCP Server v4.0.4 已启动                       ║
+║   🚀 MySQL MCP Server v4.0.5 已启动                       ║
 ║                                                           ║
 ║   📡 MCP Endpoint:  http://localhost:${PORT}/mcp           ║
 ║   💚 Health Check:  http://localhost:${PORT}/health        ║
@@ -311,6 +311,7 @@ app.listen(PORT, () => {
 ║      • AI 动态添加连接                                     ║
 ║      • 多数据库管理                                        ║
 ║      • SQL 查询执行                                        ║
+║      • 连接池 + 自动重连                                   ║
 ║                                                           ║
 ╚═══════════════════════════════════════════════════════════╝
   `);

package/package.json

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