Universal Database MCP

Remote-MCP für Google ADK und andere MCP-Clients. Ermöglicht das dynamische Verbinden von MySQL, MariaDB und PostgreSQL über eine URL sowie das Verwalten von Datenbanken, Tabellen und Datensätzen.

1. Voraussetzungen

• Python 3.13 wird empfohlen.

• Eine MySQL/MariaDB/PostgreSQL-Datenbank, die von dem Rechner aus erreichbar ist, auf dem der MCP läuft.

• Für Render: Die Datenbank muss Verbindungen aus dem Internet oder aus dem autorisierten Netzwerk akzeptieren.

Related MCP server: Read-only Database MCP

2. Lokal ausführen

Windows PowerShell:

py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env

Bearbeite .env und ersetze MCP_API_KEY durch ein langes Geheimnis.

Führe aus:

uvicorn server:app --host 0.0.0.0 --port 8000 --reload

Health:

http://127.0.0.1:8000/health

MCP:

http://127.0.0.1:8000/mcp

3. Mit MCP Inspector testen

In einem anderen Terminal:

npx -y @modelcontextprotocol/inspector

Verbinde dich mit:

http://127.0.0.1:8000/mcp

Füge im Client den Header hinzu:

Authorization: Bearer TU_MCP_API_KEY

4. Erste Verbindung

Sende zum Beispiel mit dem Tool crear_conexion:

mysql+pymysql://usuario:password@host:3306/Tareas_sena

Der Server gibt eine connection_id zurück. Verwende diese ID in allen anderen Tools.

5. Wichtig zu lokalem MySQL

Ein auf Render bereitgestellter MCP kann NICHT 127.0.0.1 oder localhost verwenden, um das MySQL auf deinem PC zu erreichen. Von Render aus bedeutet localhost den Render-Server selbst.

Für eine lokale Datenbank musst du einen lokalen Connector ausführen, der als sichere Brücke dient. In dieser ersten Version ist die Remote-API bereits vorbereitet; der Local Connector ist ein zweiter Baustein des Projekts.

6. Google ADK

Konfiguriere:

$env:MCP_URL="https://TU-SERVICIO.onrender.com/mcp"
$env:MCP_API_KEY="TU_TOKEN"

Und verwende examples/adk_agent.py als Basis.

7. Render

Du kannst dieses Repo als Web Service mit Render verbinden.

Build:

pip install -r requirements.txt

Start:

uvicorn server:app --host 0.0.0.0 --port $PORT

Variablen:

MCP_API_KEY=<tu-secreto>
MCP_REQUIRE_AUTH=true
PYTHON_VERSION=3.13.5

Der Endpoint wird lauten:

https://TU-SERVICIO.onrender.com/mcp

8. Sicherheit

Diese Version verwendet ein statisches Bearer-Token, um den Remote-Endpoint zu schützen. Die Datenbank-URLs werden ausschließlich im Prozessspeicher gehalten und in Antworten geschwärzt angezeigt.

Die Zugangsdaten der Datenbank bestimmen tatsächlich, welche Aktionen möglich sind. ejecutar_sql_admin kann beliebiges SQL mit den Berechtigungen dieses Kontos ausführen und verlangt deshalb confirmar=true.

Für den Produktionsbetrieb mit mehreren Benutzern/Agenten wird empfohlen, das globale Token durch OAuth 2.1/JWT zu ersetzen und die Verbindungen nach Benutzeridentität zu isolieren.