MCP SQL Server

Ein schreibgeschützter Model Context Protocol (MCP)-Server für Microsoft SQL Server, der es KI-Agenten ermöglicht, SQL Server-Datenbanken sicher zu erkunden und abzufragen.

Schnellstart

Schritt 1: Paket installieren

# Global installation (recommended)
npm install -g @bilims/mcp-sqlserver

# Verify installation
mcp-sqlserver --version

Schritt 2: SQL Server-Verbindung konfigurieren

Wählen Sie Ihren SQL Server-Typ und folgen Sie der Konfiguration:

Azure SQL-Datenbank

export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="false"

Lokaler SQL Server

export SQLSERVER_HOST="your-sql-server.company.com"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="true"  # For self-signed certificates

Lokaler SQL Server Express

export SQLSERVER_HOST="localhost\\SQLEXPRESS"
export SQLSERVER_USER="sa"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="master"
export SQLSERVER_ENCRYPT="false"
export SQLSERVER_TRUST_CERT="true"

Schritt 3: Verbindung testen

# Test your configuration
mcp-sqlserver --help

# Quick connection test (press Ctrl+C to exit)
mcp-sqlserver

Schritt 4: Zu Claude Desktop hinzufügen

1. Finden Sie Ihre Claude Desktop-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

2. Fügen Sie die MCP-Serverkonfiguration hinzu:

{
  "mcpServers": {
    "sqlserver": {
      "command": "mcp-sqlserver",
      "env": {
        "SQLSERVER_HOST": "your-server.database.windows.net",
        "SQLSERVER_USER": "your-username",
        "SQLSERVER_PASSWORD": "your-password",
        "SQLSERVER_DATABASE": "your-database",
        "SQLSERVER_ENCRYPT": "true",
        "SQLSERVER_TRUST_CERT": "false"
      }
    }
  }
}

3. Starten Sie Claude Desktop neu

Schritt 5: Loslegen!

Probieren Sie diese Befehle in Claude Desktop aus:

• "Testen Sie die SQL Server-Verbindung"

• "Listen Sie alle Datenbanken auf dem Server auf"

• "Zeigen Sie mir die Tabellen in [Datenbankname]"

• "Beschreiben Sie die Struktur der Users-Tabelle"

• "Zeigen Sie mir Fremdschlüsselbeziehungen"

Related MCP server: SQL Server MCP

Funktionen

• 🔒 Schreibgeschützte Operationen: Nur SELECT-Abfragen sind erlaubt, mit umfassender Sicherheitsvalidierung

• 🗄️ Schema-Erkennung: Erkunden Sie Datenbanken, Tabellen, Ansichten, Beziehungen und Metadaten

• 📊 Datenexploration: Führen Sie sichere Abfragen mit integrierten Limits und Timeouts aus

• 🔐 Enterprise-tauglich: Verschlüsselte Verbindungen mit Zertifikatsvertrauen für Produktionsumgebungen

• 🛡️ Sicherheit zuerst: Abfragevalidierung, SQL-Injection-Schutz und Zugriffskontrollen

Verfügbare Tools

Schema-Erkennung

• list_databases - Listen Sie alle Datenbanken auf der SQL Server-Instanz auf

• list_tables - Listen Sie Tabellen in einer Datenbank oder einem Schema auf

• list_views - Listen Sie Ansichten in einer Datenbank oder einem Schema auf

• describe_table - Detailliertes Tabellenschema einschließlich Spalten, Datentypen und Einschränkungen

Beziehungsanalyse

• get_foreign_keys - Fremdschlüsselbeziehungen für Tabellen abrufen

• get_table_stats - Tabellenstatistiken einschließlich Zeilenanzahl und Größeninformationen abrufen

Datenexploration

• execute_query - Schreibgeschützte SELECT-Abfragen mit Sicherheitsvalidierung ausführen

• get_server_info - SQL Server-Version, Edition und Konfigurationsdetails abrufen

Häufige Befehle für Claude Desktop

Sobald Ihr MCP-Server konfiguriert ist, probieren Sie diese natürlichen Sprachbefehle aus:

Erste Schritte

"Test the SQL Server connection"
"Show me server information"
"List all databases on this server"
"What tables are in the [database name] database?"

Datenbank-Erkundung

"Describe the structure of the Users table"
"Show me foreign key relationships in this database"
"What are the largest tables by row count?"
"Give me a sample of data from the Orders table"

Erweiterte Analyse

"Help me understand the relationship between Orders and Customers"
"Show me all lookup tables in this database"
"What columns contain date/time information?"
"Find tables that might contain user authentication data"

Benutzerdefinierte Abfragen

"Run this query: SELECT TOP 10 * FROM Products WHERE Price > 100"
"Show me all customers created in the last 30 days"
"What are the different product categories in the database?"

Installation

npm install
npm run build

Konfiguration

Der Server wird über Umgebungsvariablen konfiguriert:

Erforderlich

• SQLSERVER_USER - SQL Server-Benutzername

• SQLSERVER_PASSWORD - SQL Server-Passwort

Optional

• SQLSERVER_HOST - Server-Hostname (Standard: localhost)

• SQLSERVER_DATABASE - Standard-Datenbankname

• SQLSERVER_PORT - Portnummer (Standard: 1433)

• SQLSERVER_ENCRYPT - Verschlüsselung aktivieren (Standard: true)

• SQLSERVER_TRUST_CERT - Serverzertifikat vertrauen (Standard: true)

• SQLSERVER_CONNECTION_TIMEOUT - Verbindungs-Timeout in ms (Standard: 30000)

• SQLSERVER_REQUEST_TIMEOUT - Anforderungs-Timeout in ms (Standard: 60000)

• SQLSERVER_MAX_ROWS - Maximale Zeilen pro Abfrage (Standard: 1000)

Verwendung

Umgebungsvariablen

export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="true"

Server ausführen

npm start

Installationsoptionen

Option 1: Globale Installation (empfohlen)

npm install -g @bilims/mcp-sqlserver

Option 2: Lokale Installation

npm install @bilims/mcp-sqlserver
npx mcp-sqlserver

Option 3: Mit npx ausführen (keine Installation)

npx @bilims/mcp-sqlserver

Integrationsbeispiele

Claude Desktop

Fügen Sie Ihrer Claude Desktop-Konfiguration (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "sqlserver": {
      "command": "mcp-sqlserver",
      "env": {
        "SQLSERVER_HOST": "your-server.database.windows.net",
        "SQLSERVER_USER": "your-username",
        "SQLSERVER_PASSWORD": "your-password",
        "SQLSERVER_DATABASE": "your-database"
      }
    }
  }
}

Claude Code CLI

# Set environment variables
export SQLSERVER_HOST="your-server"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"

# Use with Claude Code
claude mcp add sqlserver mcp-sqlserver

VSCode mit MCP-Erweiterung

Installieren Sie die MCP-Erweiterung für VSCode und fügen Sie die Serverkonfiguration hinzu.

Sicherheitsfunktionen

Abfragevalidierung

• Nur SELECT-, WITH-, SHOW-, DESCRIBE- und EXPLAIN-Anweisungen sind erlaubt

• Umfassende Blacklist gefährlicher Schlüsselwörter (INSERT, UPDATE, DELETE, DROP usw.)

• Erkennung von SQL-Injection-Mustern

• Automatische Abfragebereinigung

Verbindungssicherheit

• TLS/SSL-Verschlüsselung standardmäßig aktiviert

• Optionen für Serverzertifikat-Vertrauen für Unternehmensumgebungen

• Verbindungspooling mit Timeout-Kontrollen

• Konfigurierbare Anforderungs-Timeouts

Ergebnislimits

• Maximale Zeilenlimits pro Abfrage (konfigurierbar)

• Automatische TOP-Klausel-Injektion für SELECT-Abfragen

• Abfrageausführungszeit-Tracking

• Speichernutzungsschutz

Beispielabfragen

Sobald verbunden, können Sie die Tools über Ihren MCP-Client verwenden:

// List all databases
await callTool("list_databases", {});

// List tables in a specific schema
await callTool("list_tables", { schema: "dbo" });

// Get table schema details
await callTool("describe_table", { 
  table_name: "Users", 
  schema: "dbo" 
});

// Execute a read-only query
await callTool("execute_query", { 
  query: "SELECT TOP 10 * FROM Users WHERE active = 1",
  limit: 10
});

// Get foreign key relationships
await callTool("get_foreign_keys", { 
  table_name: "Orders" 
});

Entwicklung

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run linting
npm run lint

# Run tests
npm test

Fehlerbehebung

Verbindungsprobleme

1. Überprüfen Sie Hostname und Port des Servers

2. Prüfen Sie, ob Verschlüsselungs-/Zertifikatseinstellungen mit Ihrer SQL Server-Konfiguration übereinstimmen

3. Stellen Sie sicher, dass der Benutzer über entsprechende Leseberechtigungen verfügt

4. Testen Sie die Verbindung zuerst mit SQL Server Management Studio

Berechtigungsprobleme

Das Benutzerkonto benötigt mindestens:

• CONNECT-Berechtigung für die Datenbank

• SELECT-Berechtigung für Tabellen/Ansichten, die Sie abfragen möchten

• Zugriff auf Systemansichten für Metadatenabfragen

Häufige SQL Server-Konfigurationen

Azure SQL-Datenbank

export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="false"

Lokaler SQL Server mit selbstsignierten Zertifikaten

export SQLSERVER_HOST="sql-server.company.com"
export SQLSERVER_ENCRYPT="true" 
export SQLSERVER_TRUST_CERT="true"

Lizenz

MIT

Mitwirken

1. Repository forken

2. Feature-Branch erstellen

3. Änderungen vornehmen

4. Tests hinzufügen, falls zutreffend

5. Pull-Request einreichen

Support

Bei Problemen und Fragen:

• Lesen Sie den Abschnitt zur Fehlerbehebung oben

• Überprüfen Sie die SQL Server-Verbindungsdokumentation

• Stellen Sie die MCP-Client-Kompatibilität sicher

Erstellt mit dem Model Context Protocol SDK für eine nahtlose KI-Integration.