MCP Database Server

Eine Reasoning-Schnittstelle für Datenbanken für MCP-fähige KI-Agenten – kein dünner SQL-Wrapper.

mcp-database-universal bietet KI-Agenten eine Reihe von 7 Reasoning-Tools, um eine Datenbank sicher zu erkunden und abzufragen, ihr Schema und ihre Datenstruktur zu verstehen, Fragen in natürlicher Sprache zu stellen und Beziehungen zu visualisieren – ohne rohe Verbindungsinterna preiszugeben.

Funktionen

• 7 Reasoning-Tools für KI-Agenten: Verbindung testen, Tabellen auflisten, eine Tabelle inspizieren, parametrisiertes SQL ausführen, Fragen in einfacher Sprache stellen, Daten profilieren und ein ER-Diagramm rendern.

• Multi-Engine: SQLite (integriert) plus optional PostgreSQL, MySQL und MSSQL.

• Sicherheit zuerst: standardmäßig schreibgeschützt, parametrisierte Abfragen, Anweisungsvalidierung, Zeilen-/Zeit-/Ausgabelimits.

• LLM-freundliche Ausgabe: Typen übersetzt, NULLs behandelt, Ergebnisse in Markdown-Tabellen mit Kontext formatiert.

• Schema-Introspection: automatisches Erkennen von Tabellen, Spalten, Indizes, Fremdschlüsseln und Beziehungen.

• Natürliche Sprachabfragen: Übersetzen von Klartextfragen in SQL und Rückgabe der Ergebnisse.

Related MCP server: database-explorer-mcp

Unterstützte Engines

Installation

pip install mcp-database-universal

# With optional engines:
pip install "mcp-database-universal[postgres]"
pip install "mcp-database-universal[mysql]"
pip install "mcp-database-universal[mssql]"
# or everything:
pip install "mcp-database-universal[all]"

Schnellstart

Führen Sie den Server über STDIO aus (der Standardtransport für MCP-Clients):

DATABASE_URL=sqlite:///app.db python -m mcp_database_universal

Verbindungs-URLs:

sqlite:///path/to/db.db              SQLite (file)
sqlite:///:memory:                   SQLite (in-memory)
postgresql://user:pass@host:5432/db  PostgreSQL
mysql://user:pass@host:3306/db       MySQL
mssql://user:pass@host:1433/db       MSSQL (uses ODBC Driver 18)

Docker

docker build -t mcp-db .

# Mount a SQLite database read-only:
docker run --rm -i \
  -v /host/path/app.db:/data/app.db:ro \
  -e DATABASE_URL=sqlite:////data/app.db \
  mcp-db

# Or in-memory:
docker run --rm -i -e DATABASE_URL=sqlite:///:memory: mcp-db

Konfiguration

Die gesamte Konfiguration erfolgt über Umgebungsvariablen.

Tools

Beispiel: query mit Parametern

{
  "sql": "SELECT * FROM users WHERE id = :id AND active = :active",
  "params": "{\"id\": 42, \"active\": true}"
}

Parameter verwenden :name-Platzhalter; übergeben Sie die Werte als JSON-String in params.

Beispiel: natural_query

question: "How many users are there?"
-> SELECT COUNT(*) FROM users
question: "Show me all orders"
-> SELECT * FROM orders LIMIT 100

Ein funktionierendes Beispiel mit einer kleinen Beispieldatenbank finden Sie in examples/ zusammen mit gebrauchsfertigen Konfigurationsausschnitten für gängige MCP-Clients.

MCP-Client-Konfiguration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "database": {
      "command": "python",
      "args": ["-m", "mcp_database_universal"],
      "env": {"DATABASE_URL": "sqlite:///C:/data/app.db"}
    }
  }
}

Cursor / andere CLI-basierte Clients

{
  "mcpServers": {
    "database": {
      "command": "uvx",
      "args": ["mcp-database-universal"],
      "env": {"DATABASE_URL": "sqlite:///C:/data/app.db"}
    }
  }
}

Windows-Hinweis: Der asynchrone Postgres-Treiber erfordert die Windows-Selector-Ereignisschleife. Das Paket setzt diese Richtlinie automatisch auf win32, daher ist keine zusätzliche Konfiguration erforderlich.

Entwicklung

pip install -e ".[dev]"
pytest

Integrationstests für PostgreSQL/MySQL verwenden Docker Compose und werden automatisch übersprungen, wenn die Server nicht erreichbar sind:

docker compose -f tests/integration/docker-compose.yml up -d
pytest

Sicherheitsmodell

• Der Server ist standardmäßig schreibgeschützt; INSERT/UPDATE/DELETE/DROP/ALTER und andere Schreibanweisungen werden blockiert.

• Schreibvorgänge sind nur möglich, wenn der Betreiber explizit DATABASE_READ_ONLY=false und DATABASE_WRITE_ENABLED=true setzt.

• Abfrageergebnisse sind durch Zeilenanzahl, Timeout und Ausgabegröße begrenzt – außer Kontrolle geratene Abfragen werden verhindert.

Lizenz

MIT