@eamonboyle/mssql-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,195 @@
+# MSSQL MCP Server
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js 18+](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
+
+[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=MSSQL&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBlYW1vbmJveWxlL21zc3FsLW1jcCJdLCJlbnYiOnsiU0VSVkVSX05BTUUiOiJsb2NhbGhvc3QiLCJEQVRBQkFTRV9OQU1FIjoiWW91ckRhdGFiYXNlIiwiREJfVVNFUiI6IiIsIkRCX1BBU1NXT1JEIjoiIiwiUkVBRE9OTFkiOiJmYWxzZSJ9fQ==)
+[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode://mcp/install?%7B%22name%22%3A%22mssql%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40eamonboyle%2Fmssql-mcp%22%5D%2C%22env%22%3A%7B%22SERVER_NAME%22%3A%22localhost%22%2C%22DATABASE_NAME%22%3A%22YourDatabase%22%2C%22DB_USER%22%3A%22%22%2C%22DB_PASSWORD%22%3A%22%22%2C%22READONLY%22%3A%22false%22%7D%7D)
+
+> ⚠️ **EXPERIMENTAL USE ONLY** — This MCP Server is provided for educational and experimental purposes. It is NOT intended for production use. Use appropriate security measures and test thoroughly before any deployment.
+
+## What is this? 🤔
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that lets AI assistants like Claude, Cursor, and other LLM-powered tools query and manage your Microsoft SQL Server database using natural language.
+
+### Quick Example
+
+```
+You: "Show me all customers from New York"
+AI: *queries your MSSQL database and returns the results in plain English*
+```
+
+## Features 📊
+
+- **Natural language to SQL** — Ask questions in plain English
+- **CRUD operations** — Create, read, update, and delete data
+- **Schema management** — Create tables, indexes; describe and drop tables
+- **Multi-database support** — Connect to multiple databases on the same server
+- **Read-only mode** — Restrict to SELECT-only for safer environments
+- **Secure by default** — WHERE clauses required for reads/updates; SQL injection safeguards
+
+## Supported AI Clients
+
+- [Claude Desktop](https://claude.ai/)
+- [Cursor](https://cursor.com/) (VS Code with AI)
+- [VS Code Agent](https://marketplace.visualstudio.com/items?itemName=Anthropic.anthropic-vscode) extension
+- Any MCP-compatible client
+
+## Quick Start 🚀
+
+### One-Click Install (Cursor / VS Code)
+
+Click **Add to Cursor** or **Install in VS Code** above to add the MCP server. Edit the config to add your database credentials (`DB_USER`, `DB_PASSWORD`, etc.). No cloning required—runs via `npx`.
+
+### Prerequisites
+
+- **Node.js 18** or higher
+- SQL Server (local, Azure SQL, or remote)
+- An MCP-compatible AI client (Claude Desktop, Cursor, etc.)
+
+### Installation
+
+**From npm** (recommended):
+
+```bash
+npx -y @eamonboyle/mssql-mcp
+```
+
+Or install globally: `npm install -g @eamonboyle/mssql-mcp`
+
+**From source** (for development):
+
+```bash
+git clone https://github.com/eamonboyle/mssql-mcp.git
+cd mssql-mcp
+npm install
+npm run build
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SERVER_NAME` | Yes | SQL Server host (e.g., `localhost`, `my-server.database.windows.net`) |
+| `DATABASE_NAME` | Yes | Default database name |
+| `DB_USER` | Yes* | SQL Server username (for SQL authentication) |
+| `DB_PASSWORD` | Yes* | SQL Server password (for SQL authentication) |
+| `READONLY` | No | `"true"` for read-only mode, `"false"` for full access (default: `"false"`) |
+| `DATABASES` | No | Comma-separated list for multi-database access (e.g., `ProdDB,StagingDB`) |
+| `CONNECTION_TIMEOUT` | No | Timeout in seconds (default: `30`) |
+| `TRUST_SERVER_CERTIFICATE` | No | `"true"` for self-signed certs (e.g., local dev) (default: `"false"`) |
+
+\* Required for SQL authentication. For Windows/Integrated authentication, consult the [mssql](https://www.npmjs.com/package/mssql) package documentation.
+
+### Option 1: Cursor / VS Code Setup
+
+1. Create or edit `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "mcpServers": {
+    "mssql": {
+      "command": "npx",
+      "args": ["-y", "@eamonboyle/mssql-mcp"],
+      "env": {
+        "SERVER_NAME": "localhost",
+        "DATABASE_NAME": "YourDatabase",
+        "DB_USER": "your_username",
+        "DB_PASSWORD": "your_password",
+        "READONLY": "false"
+      }
+    }
+  }
+}
+```
+
+2. Restart Cursor/VS Code.
+
+### Option 2: Claude Desktop Setup
+
+1. Open **File → Settings → Developer → Edit Config**
+2. Add the MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "mssql": {
+      "command": "npx",
+      "args": ["-y", "@eamonboyle/mssql-mcp"],
+      "env": {
+        "SERVER_NAME": "localhost",
+        "DATABASE_NAME": "YourDatabase",
+        "DB_USER": "your_username",
+        "DB_PASSWORD": "your_password",
+        "READONLY": "false"
+      }
+    }
+  }
+}
+```
+
+3. Restart Claude Desktop.
+
+### Multi-Database Support
+
+To allow queries across multiple databases:
+
+```json
+"env": {
+  "SERVER_NAME": "your-server.database.windows.net",
+  "DATABASE_NAME": "ProdDB",
+  "DATABASES": "ProdDB,StagingDB,AnalyticsDB",
+  "DB_USER": "your_username",
+  "DB_PASSWORD": "your_password",
+  "READONLY": "false"
+}
+```
+
+All tools accept an optional `databaseName` parameter. When omitted, `DATABASE_NAME` is used.
+
+## Sample Configurations
+
+See `src/samples/` for example configs:
+
+- `claude_desktop_config.json` — Claude Desktop
+- `vscode_agent_config.json` — VS Code Agent
+
+## Usage Examples
+
+Once configured, you can ask things like:
+
+- "Show me all users from New York"
+- "Create a new table called products with columns for id, name, and price"
+- "Update all pending orders to completed status"
+- "List all tables in the database"
+- "Describe the schema of the customers table"
+
+## Available Tools
+
+| Tool | Read-only | Description |
+|------|-----------|-------------|
+| `read_data` | ✓ | Execute SELECT queries |
+| `list_table` | ✓ | List tables in a database |
+| `describe_table` | ✓ | Get table schema |
+| `insert_data` | | Insert rows |
+| `update_data` | | Update rows (requires WHERE) |
+| `create_table` | | Create tables |
+| `create_index` | | Create indexes |
+| `drop_table` | | Drop tables |
+
+## Security Notes
+
+- **Credentials** — Never commit `DB_USER`/`DB_PASSWORD` or config files with secrets. Use environment variables or a secrets manager.
+- **Read-only mode** — Set `READONLY: "true"` when you only need queries.
+- **WHERE clauses** — Read and update operations require explicit WHERE clauses to reduce accidental full-table operations.
+- **SQL injection** — The server validates and restricts dangerous SQL patterns.
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

package/dist/db.d.ts

@@ -0,0 +1,25 @@
+import sql from "mssql";
+/**
+ * Returns the list of allowed database names.
+ * If DATABASES is set, returns those; otherwise returns only DATABASE_NAME.
+ */
+export declare function getAllowedDatabases(): string[];
+/**
+ * Resolves the database name to use (param or default).
+ * Returns null if invalid.
+ */
+export declare function resolveDatabaseName(databaseName?: string): string | null;
+/**
+ * Ensures a connection pool exists for the given database.
+ */
+export declare function ensureSqlConnection(databaseName: string): Promise<sql.ConnectionPool>;
+/**
+ * Returns a sql.Request for the given database.
+ * Resolves database name (param or default), validates against allowed list,
+ * ensures connection, and returns pool.request().
+ */
+export declare function getSqlRequest(databaseName?: string): Promise<{
+    request: sql.Request;
+    error?: string;
+}>;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AAKxB;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAO9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxE;AAwBD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAoB7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAYnD"}

package/dist/db.js

@@ -0,0 +1,90 @@
+import sql from "mssql";
+// Connection pools keyed by database name
+const sqlPools = new Map();
+/**
+ * Returns the list of allowed database names.
+ * If DATABASES is set, returns those; otherwise returns only DATABASE_NAME.
+ */
+export function getAllowedDatabases() {
+    const databasesEnv = process.env.DATABASES;
+    if (databasesEnv && databasesEnv.trim()) {
+        return databasesEnv.split(",").map((db) => db.trim()).filter(Boolean);
+    }
+    const defaultDb = process.env.DATABASE_NAME;
+    return defaultDb ? [defaultDb] : [];
+}
+/**
+ * Resolves the database name to use (param or default).
+ * Returns null if invalid.
+ */
+export function resolveDatabaseName(databaseName) {
+    const resolved = databaseName?.trim() || process.env.DATABASE_NAME?.trim();
+    if (!resolved)
+        return null;
+    const allowed = getAllowedDatabases();
+    if (allowed.length === 0)
+        return resolved; // No validation if nothing configured
+    if (allowed.includes(resolved))
+        return resolved;
+    return null;
+}
+function createSqlConfigForDatabase(databaseName) {
+    const trustServerCertificate = process.env.TRUST_SERVER_CERTIFICATE?.toLowerCase() === "true";
+    const connectionTimeout = process.env.CONNECTION_TIMEOUT
+        ? parseInt(process.env.CONNECTION_TIMEOUT, 10)
+        : 30;
+    return {
+        server: process.env.SERVER_NAME || "localhost",
+        database: databaseName,
+        user: process.env.DB_USER,
+        password: process.env.DB_PASSWORD,
+        options: {
+            encrypt: false,
+            trustServerCertificate: trustServerCertificate || true,
+            enableArithAbort: true,
+            useUTC: false,
+        },
+        connectionTimeout: connectionTimeout * 1000,
+    };
+}
+/**
+ * Ensures a connection pool exists for the given database.
+ */
+export async function ensureSqlConnection(databaseName) {
+    const existing = sqlPools.get(databaseName);
+    if (existing && existing.connected) {
+        return existing;
+    }
+    if (existing) {
+        try {
+            await existing.close();
+        }
+        catch {
+            // Ignore close errors
+        }
+        sqlPools.delete(databaseName);
+    }
+    const config = createSqlConfigForDatabase(databaseName);
+    const pool = new sql.ConnectionPool(config);
+    await pool.connect();
+    sqlPools.set(databaseName, pool);
+    return pool;
+}
+/**
+ * Returns a sql.Request for the given database.
+ * Resolves database name (param or default), validates against allowed list,
+ * ensures connection, and returns pool.request().
+ */
+export async function getSqlRequest(databaseName) {
+    const resolved = resolveDatabaseName(databaseName);
+    if (!resolved) {
+        const allowed = getAllowedDatabases();
+        return {
+            request: null,
+            error: `Invalid or disallowed database. Allowed: ${allowed.join(", ") || "DATABASE_NAME"}. Use databaseName parameter to target a specific database.`,
+        };
+    }
+    const pool = await ensureSqlConnection(resolved);
+    return { request: pool.request() };
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+// Internal imports
+import { UpdateDataTool } from './tools/UpdateDataTool.js';
+import { InsertDataTool } from './tools/InsertDataTool.js';
+import { ReadDataTool } from './tools/ReadDataTool.js';
+import { CreateTableTool } from './tools/CreateTableTool.js';
+import { CreateIndexTool } from './tools/CreateIndexTool.js';
+import { ListTableTool } from './tools/ListTableTool.js';
+import { DropTableTool } from './tools/DropTableTool.js';
+import { DescribeTableTool } from './tools/DescribeTableTool.js';
+const updateDataTool = new UpdateDataTool();
+const insertDataTool = new InsertDataTool();
+const readDataTool = new ReadDataTool();
+const createTableTool = new CreateTableTool();
+const createIndexTool = new CreateIndexTool();
+const listTableTool = new ListTableTool();
+const dropTableTool = new DropTableTool();
+const describeTableTool = new DescribeTableTool();
+const server = new Server({
+    name: 'mssql-mcp-server',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Read READONLY env variable
+const isReadOnly = process.env.READONLY === 'true';
+// Request handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: isReadOnly
+        ? [listTableTool, readDataTool, describeTableTool] // todo: add searchDataTool to the list of tools available in readonly mode once implemented
+        : [insertDataTool, readDataTool, describeTableTool, updateDataTool, createTableTool, createIndexTool, dropTableTool, listTableTool], // add all new tools here
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case insertDataTool.name:
+                result = await insertDataTool.run(args);
+                break;
+            case readDataTool.name:
+                result = await readDataTool.run(args);
+                break;
+            case updateDataTool.name:
+                result = await updateDataTool.run(args);
+                break;
+            case createTableTool.name:
+                result = await createTableTool.run(args);
+                break;
+            case createIndexTool.name:
+                result = await createIndexTool.run(args);
+                break;
+            case listTableTool.name:
+                result = await listTableTool.run(args);
+                break;
+            case dropTableTool.name:
+                result = await dropTableTool.run(args);
+                break;
+            case describeTableTool.name:
+                if (!args || typeof args.tableName !== 'string') {
+                    return {
+                        content: [{ type: 'text', text: `Missing or invalid 'tableName' argument for describe_table tool.` }],
+                        isError: true,
+                    };
+                }
+                result = await describeTableTool.run(args);
+                break;
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: 'text', text: `Error occurred: ${error}` }],
+            isError: true,
+        };
+    }
+});
+// Server startup
+async function runServer() {
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.error('Fatal error running server:', error);
+        process.exit(1);
+    }
+}
+runServer().catch((error) => {
+    console.error('Fatal error running server:', error);
+    process.exit(1);
+});
+// Tools call getSqlRequest(databaseName) internally - no wrapping needed
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/CreateIndexTool.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare class CreateIndexTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: any): Promise<{
+        success: boolean;
+        message: string;
+        details?: undefined;
+    } | {
+        success: boolean;
+        message: string;
+        details: {
+            schemaName: any;
+            tableName: any;
+            indexName: any;
+            columnNames: any;
+            isUnique: any;
+            isClustered: any;
+        };
+    }>;
+}
+//# sourceMappingURL=CreateIndexTool.d.ts.map

package/dist/tools/CreateIndexTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateIndexTool.d.ts","sourceRoot":"","sources":["../../src/tools/CreateIndexTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,qBAAa,eAAgB,YAAW,IAAI;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAkB;IACtB,WAAW,SAAkF;IAC7F,WAAW,MA2BF;IAEH,GAAG,CAAC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;CAsCtB"}

package/dist/tools/CreateIndexTool.js

@@ -0,0 +1,72 @@
+import { getSqlRequest } from "../db.js";
+export class CreateIndexTool {
+    constructor() {
+        this.name = "create_index";
+        this.description = "Creates an index on a specified column or columns in an MSSQL Database table";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                schemaName: { type: "string", description: "Name of the schema containing the table" },
+                tableName: { type: "string", description: "Name of the table to create index on" },
+                indexName: { type: "string", description: "Name for the new index" },
+                columns: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Array of column names to include in the index"
+                },
+                isUnique: {
+                    type: "boolean",
+                    description: "Whether the index should enforce uniqueness (default: false)",
+                    default: false
+                },
+                isClustered: {
+                    type: "boolean",
+                    description: "Whether the index should be clustered (default: false)",
+                    default: false
+                },
+                databaseName: {
+                    type: "string",
+                    description: "Name of the database to use (optional). Omit to use the default database."
+                },
+            },
+            required: ["tableName", "indexName", "columns"],
+        };
+    }
+    async run(params) {
+        try {
+            const { schemaName, tableName, indexName, columns, databaseName, isUnique = false, isClustered = false } = params;
+            const { request, error } = await getSqlRequest(databaseName);
+            if (error) {
+                return { success: false, message: error };
+            }
+            let indexType = isClustered ? "CLUSTERED" : "NONCLUSTERED";
+            if (isUnique) {
+                indexType = `UNIQUE ${indexType}`;
+            }
+            const columnNames = columns.join(", ");
+            const tableRef = schemaName ? `${schemaName}.${tableName}` : tableName;
+            const query = `CREATE ${indexType} INDEX ${indexName} ON ${tableRef} (${columnNames})`;
+            await request.query(query);
+            return {
+                success: true,
+                message: `Index [${indexName}] created successfully on table [${tableRef}]`,
+                details: {
+                    schemaName: schemaName || undefined,
+                    tableName,
+                    indexName,
+                    columnNames,
+                    isUnique,
+                    isClustered
+                }
+            };
+        }
+        catch (error) {
+            console.error("Error creating index:", error);
+            return {
+                success: false,
+                message: `Failed to create index: ${error}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=CreateIndexTool.js.map

package/dist/tools/CreateIndexTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateIndexTool.js","sourceRoot":"","sources":["../../src/tools/CreateIndexTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,eAAe;IAA5B;QAEE,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,8EAA8E,CAAC;QAC7F,gBAAW,GAAG;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACtF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBAClF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;gBACpE,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,8DAA8D;oBAC3E,OAAO,EAAE,KAAK;iBACf;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,wDAAwD;oBACrE,OAAO,EAAE,KAAK;iBACf;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC;SACzC,CAAC;IAwCX,CAAC;IAtCC,KAAK,CAAC,GAAG,CAAC,MAAW;QACnB,IAAI;YACF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,GAAG,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;YAElH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,CAAC;YAC7D,IAAI,KAAK,EAAE;gBACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC3C;YAED,IAAI,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YAC3D,IAAI,QAAQ,EAAE;gBACZ,SAAS,GAAG,UAAU,SAAS,EAAE,CAAC;aACnC;YACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACvE,MAAM,KAAK,GAAG,UAAU,SAAS,UAAU,SAAS,OAAO,QAAQ,KAAK,WAAW,GAAG,CAAC;YACvF,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAE3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,UAAU,SAAS,oCAAoC,QAAQ,GAAG;gBAC3E,OAAO,EAAE;oBACP,UAAU,EAAE,UAAU,IAAI,SAAS;oBACnC,SAAS;oBACT,SAAS;oBACT,WAAW;oBACX,QAAQ;oBACR,WAAW;iBACZ;aACF,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,2BAA2B,KAAK,EAAE;aAC5C,CAAC;SACH;IACH,CAAC;CACF"}

package/dist/tools/CreateTableTool.d.ts

@@ -0,0 +1,12 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare class CreateTableTool implements Tool {
+    [key: string]: any;
+    name: string;
+    description: string;
+    inputSchema: any;
+    run(params: any): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=CreateTableTool.d.ts.map

package/dist/tools/CreateTableTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTableTool.d.ts","sourceRoot":"","sources":["../../src/tools/CreateTableTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,qBAAa,eAAgB,YAAW,IAAI;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,IAAI,SAAkB;IACtB,WAAW,SAA2E;IACtF,WAAW,MAsBF;IAEH,GAAG,CAAC,MAAM,EAAE,GAAG;;;;CA2BtB"}

package/dist/tools/CreateTableTool.js

@@ -0,0 +1,57 @@
+import { getSqlRequest } from "../db.js";
+export class CreateTableTool {
+    constructor() {
+        this.name = "create_table";
+        this.description = "Creates a new table in the MSSQL Database with the specified columns.";
+        this.inputSchema = {
+            type: "object",
+            properties: {
+                tableName: { type: "string", description: "Name of the table to create" },
+                columns: {
+                    type: "array",
+                    description: "Array of column definitions (e.g., [{ name: 'id', type: 'INT PRIMARY KEY' }, ...])",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string", description: "Column name" },
+                            type: { type: "string", description: "SQL type and constraints (e.g., 'INT PRIMARY KEY', 'NVARCHAR(255) NOT NULL')" }
+                        },
+                        required: ["name", "type"]
+                    }
+                },
+                databaseName: {
+                    type: "string",
+                    description: "Name of the database to use (optional). Omit to use the default database."
+                },
+            },
+            required: ["tableName", "columns"],
+        };
+    }
+    async run(params) {
+        try {
+            const { tableName, columns, databaseName } = params;
+            const { request, error } = await getSqlRequest(databaseName);
+            if (error) {
+                return { success: false, message: error };
+            }
+            if (!Array.isArray(columns) || columns.length === 0) {
+                throw new Error("'columns' must be a non-empty array");
+            }
+            const columnDefs = columns.map((col) => `[${col.name}] ${col.type}`).join(", ");
+            const query = `CREATE TABLE [${tableName}] (${columnDefs})`;
+            await request.query(query);
+            return {
+                success: true,
+                message: `Table '${tableName}' created successfully.`
+            };
+        }
+        catch (error) {
+            console.error("Error creating table:", error);
+            return {
+                success: false,
+                message: `Failed to create table: ${error}`
+            };
+        }
+    }
+}
+//# sourceMappingURL=CreateTableTool.js.map

package/dist/tools/CreateTableTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateTableTool.js","sourceRoot":"","sources":["../../src/tools/CreateTableTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,eAAe;IAA5B;QAEE,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,uEAAuE,CAAC;QACtF,gBAAW,GAAG;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;gBACzE,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,oFAAoF;oBACjG,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;4BACpD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8EAA8E,EAAE;yBACtH;wBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;qBAC3B;iBACF;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;SAC5B,CAAC;IA6BX,CAAC;IA3BC,KAAK,CAAC,GAAG,CAAC,MAAW;QACnB,IAAI;YACF,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;YAEpD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,CAAC;YAC7D,IAAI,KAAK,EAAE;gBACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC3C;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;gBACnD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;aACxD;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrF,MAAM,KAAK,GAAG,iBAAiB,SAAS,MAAM,UAAU,GAAG,CAAC;YAC5D,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,UAAU,SAAS,yBAAyB;aACtD,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,2BAA2B,KAAK,EAAE;aAC5C,CAAC;SACH;IACH,CAAC;CACF"}