In diesem Leitfaden wird beschrieben, wie Sie die MCP Toolbox for Databases verwenden, um Ihre Cloud SQL-Instanz mit verschiedenen integrierten Entwicklungsumgebungen (IDEs) und Entwicklertools zu verbinden, die das Model Context Protocol (MCP) unterstützen. Mit diesen Tools können Sie SQL-Abfragen ausführen und mit Ihrer Datenbank interagieren.
Das Model Context Protocol (MCP) ist ein offenes Protokoll zum Verbinden von Large Language Models (LLMs) mit Datenquellen wie Cloud SQL. Die folgenden IDEs werden unterstützt:
- Cursor
- Windsurf
- Visual Studio Code (Copilot)
- Cline(VS Code-Erweiterung)
- Claude für Computer
- Claude-Code
- Gemini-CLI
- Gemini Code Assist
Hinweise
Wählen Sie in der Google Cloud -Console auf der Seite der Projektauswahl ein Google Cloud -Projekt aus oder erstellen Sie eines.
Die Abrechnung für Ihr Google Cloud-Projekt muss aktiviert sein.
Aktivieren Sie die Cloud SQL Admin API im Google Cloud-Projekt.
Prüfen Sie, ob Öffentliche IP für die Cloud SQL-Instanz eingerichtet ist. Standardmäßig weist Cloud SQL einer neuen Instanz eine öffentliche IP-Adresse zu. Toolbox stellt eine sichere Verbindung über die Cloud SQL Language Connectors her.
Konfigurieren Sie die erforderlichen Rollen und Berechtigungen, um diese Aufgabe auszuführen. Sie benötigen die Rolle Cloud SQL > Client (
roles/cloudsql.client) oder entsprechende Identity and Access Management-Berechtigungen, um eine Verbindung zur Instanz herzustellen.Konfigurieren Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) für Ihre Umgebung.
Erstellen oder verwenden Sie einen Datenbanknutzer und halten Sie den Nutzernamen und das Passwort bereit.
MCP-Toolbox installieren
Laden Sie zum Installieren der Toolbox die Binärdatei herunter, die Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht.
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
So machen Sie die Binärdatei ausführbar:
chmod +x toolboxPrüfen Sie die Installation mit dem folgenden Befehl:
./toolbox --version
MCP-Client konfigurieren
Claude-Code
1. Installieren Sie Claude Code.
2. Erstellen Sie im Stammverzeichnis Ihres Projekts die Datei
.mcp.json, falls sie noch nicht vorhanden ist. 3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
Claude für den Computer
1. Öffnen Sie Claude Desktop und rufen Sie die Einstellungen auf.
2. Tippen Sie auf dem Tab „Entwickler“ auf „Konfiguration bearbeiten“, um die Konfigurationsdatei zu öffnen.
3. Fügen Sie die Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
5. Starten Sie Claude Desktop neu.
6. Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen verfügbaren MCP-Server angezeigt.
Cline
1. Öffnen Sie die Cline-Erweiterung in VS Code und tippen Sie auf das Symbol MCP Servers.
2. Tippen Sie auf „MCP-Server konfigurieren“, um die Konfigurationsdatei zu öffnen.
3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
4. Nach erfolgreicher Verbindung des Servers wird ein grüner aktiver Status angezeigt.
Cursor
1. Erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis
.cursor, falls es noch nicht vorhanden ist. 2. Erstellen Sie die Datei
.cursor/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie.3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
4. Öffnen Sie Cursor und gehen Sie zu Einstellungen > Cursoreinstellungen > MCP. Wenn der Server verbunden ist, wird ein grüner aktiver Status angezeigt.
Visual Studio Code (Copilot)
1. Öffnen Sie VS Code und erstellen Sie das Verzeichnis
.vscode im Stammverzeichnis Ihres Projekts, falls es noch nicht vorhanden ist. 2. Erstellen Sie die Datei
.vscode/mcp.json, falls sie noch nicht vorhanden ist, und öffnen Sie sie. 3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcp": {
"servers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql,"--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
}
Windsurfen
1. Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
2. Tippen Sie auf das MCP-Symbol und dann auf Konfigurieren, um die Konfigurationsdatei zu öffnen.
3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql,"--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
Gemini CLI
1. Installieren Sie die Gemini CLI.
2. Erstellen Sie in Ihrem Arbeitsverzeichnis einen Ordner mit dem Namen
.gemini. Erstellen Sie darin eine settings.json-Datei.3. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql,"--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
Gemini Code Assist
1. Installieren Sie die Erweiterung Gemini Code Assist in Visual Studio Code.
2. Aktivieren Sie den Agent-Modus im Gemini Code Assist-Chat.
3. Erstellen Sie in Ihrem Arbeitsverzeichnis einen Ordner mit dem Namen
.gemini. Erstellen Sie darin eine settings.json-Datei.4. Fügen Sie die folgende Konfiguration hinzu, ersetzen Sie die Umgebungsvariablen durch Ihre Werte und speichern Sie die Datei:
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-mysql,"--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
Tools verwenden
Ihr KI-Tool ist jetzt über MCP mit Cloud SQL verbunden. Sie können Ihren KI-Assistenten bitten, Tabellen aufzulisten, eine Tabelle zu erstellen oder andere SQL-Anweisungen zu definieren und auszuführen.
Dem LLM stehen die folgenden Tools zur Verfügung:
- list_tables: Listet Tabellen und Beschreibungen auf.
- execute_sql: beliebige SQL-Anweisung ausführen