@connorbritain/mssql-mcp-server 0.1.0

package/dist/tools/UpdateDataTool.js

@@ -0,0 +1,117 @@
+import sql from "mssql";
+export class UpdateDataTool {
+    constructor() {
+        this.name = "update_data";
+        this.description = "Updates data in an MSSQL Database table with preview and confirmation. Shows affected rows before committing changes. The WHERE clause must be provided for security.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                tableName: {
+                    type: "string",
+                    description: "Name of the table to update"
+                },
+                updates: {
+                    type: "object",
+                    description: "Key-value pairs of columns to update. Example: { 'status': 'active', 'last_updated': '2025-01-01' }",
+                },
+                whereClause: {
+                    type: "string",
+                    description: "WHERE clause to identify which records to update. Example: \"genre = 'comedy' AND created_date <= '2025-07-05'\""
+                },
+                confirmUpdate: {
+                    type: "boolean",
+                    description: "Set to true to confirm and execute the update after preview. First call without this to see preview.",
+                },
+                maxRows: {
+                    type: "number",
+                    description: "Maximum number of rows allowed to update. Defaults to 1000 for safety.",
+                },
+                environment: {
+                    type: "string",
+                    description: "Optional environment name to target",
+                },
+            },
+            required: ["tableName", "updates", "whereClause"],
+        };
+    }
+    async run(params) {
+        let query;
+        try {
+            const { tableName, updates, whereClause, confirmUpdate, maxRows, environment } = params;
+            // Basic validation: ensure whereClause is not empty
+            if (!whereClause || whereClause.trim() === '') {
+                return {
+                    success: false,
+                    message: "WHERE clause is required for security reasons. Use 'WHERE 1=1' to update all rows (not recommended).",
+                    error: "MISSING_WHERE_CLAUSE",
+                };
+            }
+            const maxAllowed = maxRows || UpdateDataTool.MAX_ROWS_DEFAULT;
+            // Step 1: Get count of affected rows
+            const countQuery = `SELECT COUNT(*) as affectedRows FROM ${tableName} WHERE ${whereClause}`;
+            const countRequest = new sql.Request();
+            const countResult = await countRequest.query(countQuery);
+            const affectedRows = countResult.recordset[0].affectedRows;
+            if (affectedRows === 0) {
+                return {
+                    success: false,
+                    message: "No rows match the WHERE clause. No update will be performed.",
+                    error: "NO_ROWS_MATCHED",
+                    affectedRows: 0,
+                };
+            }
+            if (affectedRows > maxAllowed) {
+                return {
+                    success: false,
+                    message: `Update would affect ${affectedRows} rows, which exceeds the maximum of ${maxAllowed}. Refine your WHERE clause or increase maxRows parameter.`,
+                    error: "TOO_MANY_ROWS",
+                    affectedRows,
+                    maxAllowed,
+                };
+            }
+            // Step 2: Show preview if not confirmed
+            if (!confirmUpdate) {
+                const previewQuery = `SELECT TOP 10 * FROM ${tableName} WHERE ${whereClause}`;
+                const previewRequest = new sql.Request();
+                const previewResult = await previewRequest.query(previewQuery);
+                return {
+                    success: false,
+                    needsConfirmation: true,
+                    message: `Preview: ${affectedRows} row(s) will be updated. Review the preview below and re-run with confirmUpdate: true to proceed.`,
+                    affectedRows,
+                    preview: previewResult.recordset,
+                    updates,
+                    error: "CONFIRMATION_REQUIRED",
+                };
+            }
+            // Step 3: Execute the update
+            const request = new sql.Request();
+            // Build SET clause with parameterized queries for security
+            const setClause = Object.keys(updates)
+                .map((key, index) => {
+                const paramName = `update_${index}`;
+                request.input(paramName, updates[key]);
+                return `[${key}] = @${paramName}`;
+            })
+                .join(", ");
+            query = `UPDATE ${tableName} SET ${setClause} WHERE ${whereClause}`;
+            const result = await request.query(query);
+            return {
+                success: true,
+                message: `Successfully updated ${result.rowsAffected[0]} row(s) in table '${tableName}'`,
+                rowsAffected: result.rowsAffected[0],
+                updates,
+            };
+        }
+        catch (error) {
+            console.error("Error updating data:", error);
+            return {
+                success: false,
+                message: `Failed to update data${query ? ` with '${query}'` : ''}: ${error}`,
+                error: "UPDATE_FAILED",
+            };
+        }
+    }
+}
+UpdateDataTool.MAX_ROWS_DEFAULT = 1000;
+//# sourceMappingURL=UpdateDataTool.js.map

package/dist/tools/UpdateDataTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateDataTool.js","sourceRoot":"","sources":["../../src/tools/UpdateDataTool.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@connorbritain/mssql-mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server for Microsoft SQL Server - enterprise-ready schema discovery, profiling, and safe data operations",
+  "keywords": ["mcp", "sql-server", "mssql", "database", "ai", "claude", "windsurf", "model-context-protocol"],
+  "author": "Connor England <connor.r.england@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ConnorBritain/mssql-mcp-server.git"
+  },
+  "homepage": "https://github.com/ConnorBritain/mssql-mcp-server",
+  "bugs": {
+    "url": "https://github.com/ConnorBritain/mssql-mcp-server/issues"
+  },
+  "main": "dist/index.js",
+  "bin": {
+    "mssql-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/mssql": "^9.1.7",
+    "@types/node": "^20.14.2",
+    "shx": "^0.3.4",
+    "typescript": "^5.4.5"
+  },
+  "dependencies": {
+    "@azure/identity": "^4.4.0",
+    "@modelcontextprotocol/sdk": "^1.23.0",
+    "dotenv": "^16.4.5",
+    "mssql": "^10.0.1"
+  },
+  "type": "module"
+}