@berthojoris/mcp-mysql-server 1.40.5 → 1.40.6

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to the MySQL MCP Server 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).
 
+## [1.40.6] - 2026-05-04
+
+### Added
+- Added `cursor_execute_request`, a no-argument compatibility bridge for Cursor MCP wrappers that cannot send tool `arguments`.
+- The bridge reads `.cursor/mysql-mcp-request.json` or `MYSQL_MCP_CURSOR_REQUEST_FILE` and dispatches to existing MCP tools or auto-routes SQL to SELECT, write, or DDL execution.
+
+### Changed
+- Updated tool totals in documentation to include the Cursor bridge.
+- Synchronized version metadata to `1.40.6`.
+
 ## [1.40.5] - 2026-04-08
 
 ### Fixed

package/DOCUMENTATIONS.md

@@ -1,8 +1,8 @@
 # MySQL MCP Server - Documentation
 
-**Last Updated:** 2026-04-08 14:30:00
-**Version:** 1.40.5
-**Total Tools:** 62
+**Last Updated:** 2026-05-04 18:07:52
+**Version:** 1.40.6
+**Total Tools:** 79
 
 Comprehensive documentation for the MySQL MCP Server. For quick start, see [README.md](README.md).
 
@@ -65,6 +65,34 @@ Configure MySQL MCP with two access-control layers:
 
 ---
 
+### Cursor Compatibility Bridge
+
+Some Cursor MCP wrappers can call a tool by name but cannot pass `arguments`. For that flow, write a request file at `.cursor/mysql-mcp-request.json` and call the no-argument `cursor_execute_request` tool.
+
+Execute any existing MCP tool:
+
+```json
+{
+  "tool": "execute_ddl",
+  "arguments": {
+    "query": "DROP TABLE IF EXISTS spark_processes;"
+  }
+}
+```
+
+Or execute SQL directly with automatic routing:
+
+```json
+{
+  "query": "DROP TABLE IF EXISTS spark_processes;",
+  "mode": "auto"
+}
+```
+
+Supported `mode` values are `auto`, `select`, `write`, and `ddl`. Set `MYSQL_MCP_CURSOR_REQUEST_FILE` to override the request file path.
+
+---
+
 ## Permission System
 
 ### Available Permissions
@@ -191,11 +219,12 @@ Tool enabled = (Has Permission) AND (Has Category OR No categories specified)
 - `get_optimization_hints` - Get optimizer hints
 - `repair_query` - Repair broken SQL queries
 
-### 14. Utilities (4 tools)
+### 14. Utilities (5 tools)
 - `test_connection` - Test connectivity
 - `describe_connection` - Connection info
 - `read_changelog` - Read changelog
 - `invalidate_table_cache` - Clear table cache
+- `cursor_execute_request` - Execute a file-backed request for clients that cannot send MCP arguments
 
 ---
 

package/README.md

@@ -4,7 +4,7 @@
 
 **A production-ready Model Context Protocol (MCP) server for MySQL database integration with AI agents**
 
-**Last Updated:** 2026-04-08 14:30:00
+**Last Updated:** 2026-05-04 18:07:52
 
 [![npm version](https://img.shields.io/npm/v/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mcp-mysql-server)
 [![npm downloads](https://img.shields.io/npm/dm/@berthojoris/mcp-mysql-server)](https://www.npmjs.com/package/@berthojoris/mcp-mysql-server)
@@ -211,6 +211,32 @@ For more client-specific config snippets, see **[DOCUMENTATIONS.md → Setup & C
 
 ---
 
+### Cursor Compatibility Bridge
+
+If a Cursor MCP wrapper can call tools but cannot send `arguments`, use the no-argument `cursor_execute_request` bridge. Create `.cursor/mysql-mcp-request.json` in the workspace, then call `cursor_execute_request`:
+
+```json
+{
+  "tool": "execute_ddl",
+  "arguments": {
+    "query": "DROP TABLE IF EXISTS spark_processes;"
+  }
+}
+```
+
+For direct SQL, the bridge can infer the right SQL tool:
+
+```json
+{
+  "query": "DROP TABLE IF EXISTS spark_processes;",
+  "mode": "auto"
+}
+```
+
+Set `MYSQL_MCP_CURSOR_REQUEST_FILE` to override the request file path.
+
+---
+
 ## Permission System
 
 Control database access with a **dual-layer filtering system** that provides both broad and fine-grained control:
@@ -250,7 +276,7 @@ Use documentation categories to fine-tune which tools are exposed (Layer 2):
 | `bulk_operations` | High-performance batch processing operations | `bulk_delete, bulk_insert, bulk_update` |
 | `custom_queries` | Execute custom SQL queries and advanced operations | `execute_write_query, run_select_query` |
 | `schema_management` | Manage database schema, tables, and structure | `alter_table, create_table, drop_table, execute_ddl` |
-| `utilities` | Database utilities, diagnostics, and helper functions | `describe_connection, export_query_to_csv, export_table_to_csv, list_all_tools, read_changelog, test_connection` |
+| `utilities` | Database utilities, diagnostics, and helper functions | `cursor_execute_request, describe_connection, export_query_to_csv, export_table_to_csv, list_all_tools, read_changelog, test_connection` |
 | `transaction_management` | Handle ACID transactions and rollback operations | `begin_transaction, commit_transaction, execute_in_transaction, get_transaction_status, rollback_transaction` |
 | `stored_procedures` | Create, execute, and manage stored procedures | `create_stored_procedure, drop_stored_procedure, execute_stored_procedure, get_stored_procedure_info, list_stored_procedures, show_create_procedure` |
 | `views_management` | Create and manage database views | `alter_view, create_view, drop_view, get_view_info, list_views, show_create_view` |
@@ -276,7 +302,7 @@ Full category → tool mapping (and examples) lives in **[DOCUMENTATIONS.md →
 
 ## Available Tools
 
-The server exposes **62 tools** organized into categories (CRUD, schema, and utilities).
+The server exposes **79 tools** organized into categories (CRUD, schema, and utilities).
 
 - Complete list of tools: **[DOCUMENTATIONS.md → Complete Tools Reference](DOCUMENTATIONS.md#🔧-complete-tools-reference)**
 

package/dist/config/featureConfig.js

@@ -81,6 +81,8 @@ exports.toolCategoryMap = {
     executeDdl: ToolCategory.DDL,
     // Utility tools
     describeConnection: ToolCategory.UTILITY,
+    cursorExecuteRequest: ToolCategory.UTILITY,
+    cursor_execute_request: ToolCategory.UTILITY,
     testConnection: ToolCategory.UTILITY,
     getAllTablesRelationships: ToolCategory.UTILITY,
     exportTableToCSV: ToolCategory.UTILITY,
@@ -183,6 +185,8 @@ exports.toolDocCategoryMap = {
     // Utilities
     testConnection: DocCategory.UTILITIES,
     describeConnection: DocCategory.UTILITIES,
+    cursorExecuteRequest: DocCategory.UTILITIES,
+    cursor_execute_request: DocCategory.UTILITIES,
     exportTableToCSV: DocCategory.UTILITIES,
     exportTableToCsv: DocCategory.UTILITIES,
     export_table_to_csv: DocCategory.UTILITIES,

package/dist/mcp-server.js

@@ -1,6 +1,11 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
@@ -641,6 +646,14 @@ const TOOLS = [
             properties: {},
         },
     },
+    {
+        name: "cursor_execute_request",
+        description: "Cursor compatibility bridge for clients that can call MCP tools but cannot send arguments. Reads .cursor/mysql-mcp-request.json (or MYSQL_MCP_CURSOR_REQUEST_FILE) and dispatches to the requested MySQL MCP tool. The request file supports {\"tool\":\"execute_ddl\",\"arguments\":{\"query\":\"DROP TABLE IF EXISTS t;\"}} or direct SQL with {\"query\":\"...\",\"mode\":\"auto\"}.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
     {
         name: "read_changelog",
         description: "Reads the MySQL MCP Server changelog to see version history, new features, bug fixes, and breaking changes. Useful for understanding tool capabilities and recent updates.",
@@ -1850,7 +1863,7 @@ const TOOLS = [
 // Create the MCP server
 const server = new index_js_1.Server({
     name: "mysql-mcp-server",
-    version: "1.40.5",
+    version: "1.40.6",
 }, {
     capabilities: {
         tools: {},
@@ -1865,6 +1878,90 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
         tools: enabledTools,
     };
 });
+const TOOL_METHOD_OVERRIDES = {
+    get_schema_erd: "getSchemaERD",
+    export_table_to_csv: "exportTableToCSV",
+    export_query_to_csv: "exportQueryToCSV",
+};
+const toCamelCase = (value) => value.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+const getCursorRequestFilePath = () => {
+    const configuredPath = process.env.MYSQL_MCP_CURSOR_REQUEST_FILE ||
+        process.env.MCP_MYSQL_REQUEST_FILE ||
+        ".cursor/mysql-mcp-request.json";
+    return path_1.default.isAbsolute(configuredPath)
+        ? configuredPath
+        : path_1.default.resolve(process.cwd(), configuredPath);
+};
+const inferSqlToolName = (query, mode = "auto") => {
+    const upperQuery = query.trim().toUpperCase();
+    if (mode === "select")
+        return "run_select_query";
+    if (mode === "write")
+        return "execute_write_query";
+    if (mode === "ddl")
+        return "execute_ddl";
+    if (/^(CREATE|ALTER|DROP|TRUNCATE|RENAME)\b/.test(upperQuery)) {
+        return "execute_ddl";
+    }
+    if (/^(INSERT|UPDATE|DELETE|REPLACE)\b/.test(upperQuery)) {
+        return "execute_write_query";
+    }
+    if (/^(SELECT|WITH)\b/.test(upperQuery)) {
+        return "run_select_query";
+    }
+    throw new Error("Unable to infer SQL tool. Set mode to one of: select, write, ddl.");
+};
+const executeToolByName = async (toolName, args = {}) => {
+    const knownToolNames = new Set(TOOLS.map((tool) => tool.name));
+    if (!knownToolNames.has(toolName)) {
+        throw new Error(`Unknown tool for Cursor bridge: ${toolName}`);
+    }
+    if (toolName === "cursor_execute_request") {
+        throw new Error("cursor_execute_request cannot dispatch to itself");
+    }
+    const methodName = TOOL_METHOD_OVERRIDES[toolName] || toCamelCase(toolName);
+    const method = mysqlMCP[methodName];
+    if (typeof method !== "function") {
+        throw new Error(`No handler method found for Cursor bridge tool: ${toolName}`);
+    }
+    return await method.call(mysqlMCP, args);
+};
+const executeCursorRequest = async () => {
+    const requestFilePath = getCursorRequestFilePath();
+    if (!fs_1.default.existsSync(requestFilePath)) {
+        return {
+            status: "error",
+            error: `Cursor request file not found: ${requestFilePath}. ` +
+                'Create it with JSON like {"tool":"execute_ddl","arguments":{"query":"DROP TABLE IF EXISTS spark_processes;"}}',
+        };
+    }
+    let request;
+    try {
+        request = JSON.parse(fs_1.default.readFileSync(requestFilePath, "utf8"));
+    }
+    catch (error) {
+        return {
+            status: "error",
+            error: `Failed to read Cursor request file: ${error.message}`,
+        };
+    }
+    const requestedTool = request.tool || request.toolName || request.name;
+    if (requestedTool) {
+        return await executeToolByName(requestedTool, request.arguments || request.args || {});
+    }
+    if (request.query) {
+        const inferredTool = inferSqlToolName(request.query, request.mode || "auto");
+        return await executeToolByName(inferredTool, {
+            query: request.query,
+            params: request.params,
+            dry_run: request.dry_run,
+        });
+    }
+    return {
+        status: "error",
+        error: "Cursor request must contain either tool/toolName/name with arguments, or query with optional mode.",
+    };
+};
 // Handle tool call requests
 server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
@@ -1951,6 +2048,9 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case "describe_connection":
                 result = await mysqlMCP.describeConnection();
                 break;
+            case "cursor_execute_request":
+                result = await executeCursorRequest();
+                break;
             case "test_connection":
                 result = await mysqlMCP.testConnection();
                 break;

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "mysql-mcp",
   "description": "A Model Context Protocol for MySQL database interaction",
-  "version": "1.40.4",
+  "version": "1.40.6",
   "tools": [
     {
       "name": "list_databases",
@@ -348,6 +348,17 @@
         }
       }
     },
+    {
+      "name": "cursor_execute_request",
+      "description": "Cursor compatibility bridge for clients that cannot send MCP tool arguments. Reads .cursor/mysql-mcp-request.json or MYSQL_MCP_CURSOR_REQUEST_FILE and dispatches to an existing MySQL MCP tool.",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      },
+      "output_schema": {
+        "type": "object"
+      }
+    },
     {
       "name": "list_all_tools",
       "description": "Lists all available MCP tools with their definitions and server metadata.",
@@ -730,4 +741,4 @@
       }
     }
   ]
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berthojoris/mcp-mysql-server",
-  "version": "1.40.5",
+  "version": "1.40.6",
   "description": "Model Context Protocol server for MySQL database integration with dynamic per-project permissions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",