MCP SQL Server (Entwicklung)

Professioneller MCP-Server, um jeden MCP-kompatiblen LLM mit einer SQL-Datenbank zu verbinden und Folgendes auszuführen:

• Abfragen (SELECT, WITH, SHOW usw.)

• DML (INSERT, UPDATE, DELETE)

• DDL (CREATE, ALTER und optional DROP/TRUNCATE)

Dieser Server ist für den persönlichen Gebrauch bei der assistierten Entwicklung konzipiert.

Funktionen

• MCP-Protokoll via stdio (kompatibel mit MCP-Clients).

• Multi-Engine-Verbindung mittels SQLAlchemy (sqlite, postgresql, mysql, mssql usw.).

• MCP-Tools mit Fokus auf den täglichen Betrieb:

  • sql_capabilities

  • sql_list_tables

  • sql_describe_table

  • sql_run

  • sql_run_script

• Standardmäßige Sperre für destruktives DDL (DROP/TRUNCATE gesperrt).

• Konfigurierbares Limit für Zeilen und Anweisungen pro Skript.

Installation

python -m venv .venv
source .venv/bin/activate
pip install -e .

Konfiguration (Umgebungsvariablen)

Präfix: MCP_SQL_

• MCP_SQL_DATABASE_URL: SQLAlchemy-URL. Standard: sqlite:///./dev.db

• MCP_SQL_MAX_ROWS: Maximale Anzahl der pro Abfrage zurückgegebenen Zeilen. Standard: 200

• MCP_SQL_MAX_SCRIPT_STATEMENTS: Maximale Anzahl der Anweisungen pro Skript. Standard: 100

• MCP_SQL_ALLOW_DESTRUCTIVE_DDL: true/false, um DROP und TRUNCATE zu erlauben. Standard: false

Beispiel

export MCP_SQL_DATABASE_URL='postgresql+psycopg://dev_user:dev_pass@localhost:5432/devdb'
export MCP_SQL_MAX_ROWS=500
export MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false

Server ausführen

mcp-sql-server

Sie können ihn auch als Modul ausführen:

python -m mcp_sql_server.server

Start per Doppelklick unter Windows

Die Datei start_mcp_sql_server.bat ist enthalten, um den Start zu erleichtern:

1. Erstellt automatisch .venv (falls nicht vorhanden).

2. Installiert/aktualisiert Abhängigkeiten.

3. Startet den MCP-Server.

Führen Sie einfach einen Doppelklick auf diese .bat-Datei aus.

Konfiguration in einem MCP-Client (generisches Beispiel)

{
  "mcpServers": {
    "sql-dev": {
      "command": "mcp-sql-server",
      "env": {
        "MCP_SQL_DATABASE_URL": "sqlite:///./dev.db",
        "MCP_SQL_MAX_ROWS": "200",
        "MCP_SQL_ALLOW_DESTRUCTIVE_DDL": "false"
      }
    }
  }
}

Empfohlener Ablauf

1. sql_capabilities, um die aktive Konfiguration zu überprüfen.

2. sql_list_tables, um das Schema zu erkunden.

3. sql_describe_table, um Metadaten zu untersuchen.

4. sql_run für Abfragen oder punktuelle DML-Operationen.

5. sql_run_script für kontrollierte Änderungsstapel.

Best Practices für die assistierte Entwicklung

• Verwenden Sie Datenbankbenutzer mit minimalen Berechtigungen.

• Arbeiten Sie auf einer lokalen Entwicklungs-DB oder einem wegwerfbaren Snapshot.

• Behalten Sie MCP_SQL_ALLOW_DESTRUCTIVE_DDL=false standardmäßig bei.

• Versionieren Sie strukturelle Änderungen mit Migrationen.

Sicherheitshinweis

Dieses Projekt ist nicht für den Produktionseinsatz gehärtet. Es ist auf lokale Produktivität in Entwicklungsumgebungen ausgerichtet.

Claude-Anleitung in VS Code

Lesen Sie README_CLAUDE_VSCODE.md für ein vollständiges Beispiel zur Konfiguration und Verwendung.