MCP-Server für Microsoft SQL Server

Produktionsorientierter MCP-Server für Microsoft SQL Server, der Datenbankoperationen für MCP-Clients (Claude Desktop, VS Code Copilot, Cursor und kompatible Hosts) bereitstellt.

Funktionen

• Abfrageausführung (SELECT, INSERT, UPDATE, DELETE)

• Datenbankerkennung und Schema-Introspektion

• Inspektion von Tabellenmetadaten (Spalten, Typen, Nullability, Standardwerte, PK)

• Ermittlung von Indizes und Fremdschlüsseln

Related MCP server: SQL Query Tools MCP Server

Verfügbare Tools

Voraussetzungen

• Node.js 18+

• Zugriff auf eine Microsoft SQL Server-Instanz

• Netzwerkverbindung vom MCP-Host zum SQL Server (host:port)

Konfiguration

Legen Sie die Verbindungseinstellungen mithilfe von Umgebungsvariablen fest:

* Erforderlich, wenn MSSQL_AUTH_MODE=sql.

| MCP_TRANSPORT | Nein | stdio | Transportmodus: stdio (Standard, für npx/Claude Desktop/VS Code) oder http (Streamable HTTP, für Docker/Remote-Clients wie n8n) | | MCP_HTTP_PORT | Nein | 3001 | Port für den HTTP-Server (nur verwendet, wenn MCP_TRANSPORT=http) | | MCP_HTTP_HOST | Nein | 0.0.0.0 | Bind-Adresse für den HTTP-Server (nur verwendet, wenn MCP_TRANSPORT=http) |

Hinweis: Das veröffentlichte Docker-Image läuft immer im http-Modus und baut den nativen Treiber msnodesqlv8 nicht (der nur für MSSQL_AUTH_MODE=windows verwendet wird). Die Windows-Authentifizierung ist nur verfügbar, wenn der Server direkt auf einem Windows-Host über npx/npm start ausgeführt wird.

Verwendung

Direkt von GitHub ausführen

npx github:ferronicardoso/mcp-mssqlserver

Claude Code (CLI)

claude mcp add mssqlserver --scope user -- npx -y github:ferronicardoso/mcp-mssqlserver

--scope steuert, wo die Serverregistrierung gespeichert wird:

Umgebungsvariablen können mit wiederholten --env KEY=VALUE-Flags vor dem -- übergeben werden, z. B.:

Bash (Linux/macOS/WSL):

claude mcp add mssqlserver --scope user \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  --env MSSQL_AUTH_MODE=sql \
  --env MSSQL_USER=sa \
  --env MSSQL_PASSWORD=your-password \
  -- npx -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

claude mcp add mssqlserver --scope user `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  --env MSSQL_AUTH_MODE=sql `
  --env MSSQL_USER=sa `
  --env MSSQL_PASSWORD=your-password `
  -- npx -y github:ferronicardoso/mcp-mssqlserver

Codex CLI

Bash (Linux/macOS/WSL):

codex mcp add mssqlserver \
  --env MSSQL_AUTH_MODE=sql \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  --env MSSQL_USER=sa \
  --env MSSQL_PASSWORD=your-password \
  npx -- -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

codex mcp add mssqlserver `
  --env MSSQL_AUTH_MODE=sql `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  --env MSSQL_USER=sa `
  --env MSSQL_PASSWORD=your-password `
  npx -- -y github:ferronicardoso/mcp-mssqlserver

Für die Windows-Authentifizierung lassen Sie stattdessen MSSQL_USER/MSSQL_PASSWORD weg und setzen Sie MSSQL_AUTH_MODE=windows:

Bash (Linux/macOS/WSL):

codex mcp add mssqlserver \
  --env MSSQL_AUTH_MODE=windows \
  --env MSSQL_HOST=localhost \
  --env MSSQL_PORT=1433 \
  --env MSSQL_DATABASE=master \
  npx -- -y github:ferronicardoso/mcp-mssqlserver

PowerShell:

codex mcp add mssqlserver `
  --env MSSQL_AUTH_MODE=windows `
  --env MSSQL_HOST=localhost `
  --env MSSQL_PORT=1433 `
  --env MSSQL_DATABASE=master `
  npx -- -y github:ferronicardoso/mcp-mssqlserver

Dadurch wird der Server in ~/.codex/config.toml registriert. Um ihn zu entfernen, führen Sie codex mcp remove mssqlserver aus.

Claude-Desktop-Konfiguration

%APPDATA%\\Claude\\claude_desktop_config.json:

{
  "mcpServers": {
    "mssqlserver": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-mssqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_AUTH_MODE": "sql",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "your-password"
      }
    }
  }
}

VS-Code-MCP-Konfiguration

.vscode/mcp.json:

{
  "servers": {
    "mssqlserver": {
      "command": "npx",
      "args": ["github:ferronicardoso/mcp-mssqlserver"],
      "env": {
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_AUTH_MODE": "sql",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "your-password"
      }
    }
  }
}

Mit Docker ausführen (HTTP-Transport)

Das veröffentlichte Image läuft standardmäßig im Streamable-HTTP-Modus, zur Verwendung als Remote-MCP-Endpunkt (z. B. vom MCP-Client-Tool-Knoten von n8n oder einem beliebigen Streamable-HTTP-kompatiblen Client):

Bash (Linux/macOS/WSL):

docker run -d --name mcp-mssqlserver \
  -p 3001:3001 \
  -e MSSQL_HOST=host.docker.internal \
  -e MSSQL_PORT=1433 \
  -e MSSQL_DATABASE=master \
  -e MSSQL_AUTH_MODE=sql \
  -e MSSQL_USER=sa \
  -e MSSQL_PASSWORD=your-password \
  ghcr.io/ferronicardoso/mcp-mssqlserver:latest

PowerShell:

docker run -d --name mcp-mssqlserver `
  -p 3001:3001 `
  -e MSSQL_HOST=host.docker.internal `
  -e MSSQL_PORT=1433 `
  -e MSSQL_DATABASE=master `
  -e MSSQL_AUTH_MODE=sql `
  -e MSSQL_USER=sa `
  -e MSSQL_PASSWORD=your-password `
  ghcr.io/ferronicardoso/mcp-mssqlserver:latest

Der MCP-Endpunkt ist dann unter http://localhost:3001/mcp verfügbar.

Lokale Entwicklung

git clone https://github.com/ferronicardoso/mcp-mssqlserver
cd mcp-mssqlserver
npm install
npm run build

Starten Sie den kompilierten Server:

npm start

Build- und Commit-Workflow

Dieses Repository trackt absichtlich dist/, um die Nutzung von npx github:user/repo zu unterstützen.

Das Projekt verwendet einen Husky-pre-commit-Hook, um:

1. TypeScript zu bauen (npm run build)

2. generierte Artefakte zu stagen (git add dist)

Manueller Fallback:

npm run build
git add dist

Sicherheitshinweise

• Committen Sie niemals echte Anmeldedaten oder .env-Dateien.

• Bevorzugen Sie SQL-Benutzer mit minimalen Rechten für den Produktionseinsatz.

• Aktivieren Sie für öffentliche oder nicht vertrauenswürdige Netzwerke die Verschlüsselung (MSSQL_ENCRYPT=true) und konfigurieren Sie Zertifikate entsprechend.

Windows-Authentifizierung (Integrierte Sicherheit)

Um die Windows-Authentifizierung mit integrierter Sicherheit (Prozesskonto) zu verwenden, konfigurieren Sie:

MSSQL_AUTH_MODE=windows
MSSQL_HOST=sqlserver.company.local
MSSQL_PORT=1433
MSSQL_DATABASE=master

Lizenz

MIT © Raphael Augusto Ferroni Cardoso