Database Explorer MCP

Ein FastMCP-Server zum Erkunden und sicheren Abfragen relationaler Datenbanken. Die lokale Entwicklungsdatenbank ist SQLite; SQLAlchemy unterstützt über seine Treiber auch PostgreSQL und MySQL.

Architektur

Der MCP-Client führt natürlichsprachliche Überlegungen durch und generiert SQL. Dieser Server stellt Datenbank-Tools bereit, validiert schreibgeschützte Abfragen, führt sie aus und gibt strukturierte Ergebnisse zurück.

MCP client LLM -> FastMCP tools -> safety layer -> SQLAlchemy -> database

Der Server ruft Anthropic nicht auf, daher ist kein Anthropic-API-Schlüssel erforderlich.

Related MCP server: nl2sql-mcp

Einrichtung

Installieren Sie uv und führen Sie dann in diesem Verzeichnis Folgendes aus:

uv sync
uv run python tests/seed_test_db.py
uv run pytest

Falls uv noch nicht im PATH ist, verwenden Sie:

py -m uv sync
py -m uv run pytest

Die Standarddatenbank ist:

sqlite:///sample.db

Um eine andere Datenbank zu verwenden, setzen Sie DATABASE_URL, bevor Sie den Server starten. Beispiele:

$env:DATABASE_URL = "sqlite:///C:/data/example.db"
$env:DATABASE_URL = "postgresql+psycopg2://user:password@localhost:5432/example"
$env:DATABASE_URL = "mysql+pymysql://user:password@localhost:3306/example"

MCP-Server ausführen

uv run server.py

Die gemeinsam nutzbare MCP-Konfiguration für VS Code befindet sich in .vscode/mcp.json. Sie startet den Server über stdio und kann mit MCP-kompatiblen Clients und Inspector verwendet werden.

Für Remote-Hosting verwenden Sie Streamable HTTP:

$env:MCP_TRANSPORT = "streamable-http"
$env:MCP_HOST = "0.0.0.0"
$env:MCP_PORT = "8000"
uv run server.py

Die Remote-Bereitstellung muss eine Authentifizierung bereitstellen und DATABASE_URL über ihre geheime Konfiguration schützen.

Tools

• explore_schema: Tabellen auflisten oder eine Tabelle untersuchen

• execute_query: ein sicheres, schreibgeschütztes SELECT ausführen

• explain_query: den nativen Ausführungsplan zurückgeben

• validate_schema: fehlende Primärschlüssel und nicht indizierte Fremdschlüssel melden

• suggest_index: Indizes aus Tabellenmetadaten oder einem Abfrageplan vorschlagen

• migration_context: Schemakontext für die clientseitige Migrationsgenerierung bereitstellen

• validate_migration: vorgeschlagene UP- und DOWN-Skripte validieren, ohne sie auszuführen

Jede Abfrageausführung und -erklärung durchläuft die Sicherheitsebene. Schreibende Anweisungen, Kommentare und mehrere Anweisungen werden abgelehnt. Abfrageergebnisse sind standardmäßig auf maximal 100 Zeilen begrenzt.

Tests

uv run pytest

Die Testsuite verwendet temporäre SQLite-Datenbanken und benötigt keine externen Zugangsdaten oder einen laufenden Datenbankserver.

Remote-Bereitstellung

Siehe DEPLOYMENT.md für die Bereitstellungsschritte für FastMCP Horizon, die Anforderungen an die Remote-Datenbank und die Authentifizierungs-Checkliste.