Cloud Healthcare API mit MCP und anderen Agents verwenden

In diesem Leitfaden erfahren Sie, wie Sie die MCP Toolbox for Databases verwenden, um die Cloud Healthcare API mit verschiedenen integrierten Entwicklungsumgebungen (IDEs) und Entwicklertools zu verbinden. Dabei wird das Model Context Protocol (MCP) verwendet, ein offenes Protokoll zum Verbinden von Large Language Models (LLMs) mit Datenquellen wie Gesundheitsdatensätzen. So können Sie direkt über Ihre vorhandenen Tools nach Gesundheitsdaten suchen und mit ihnen interagieren.

In diesem Leitfaden wird der Verbindungsprozess für die folgenden IDEs beschrieben:

  • Cursor
  • Windsurf (ehemals Codeium)
  • Visual Studio Code (Copilot)
  • Cline (VS Code-Erweiterung)
  • Claude für den Computer
  • Claude-Code

Hinweis

  1. Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein-Projekt aus oder erstellen Sie eines Google Cloud .

  2. Achten Sie darauf, dass die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

  3. Aktivieren Sie die Cloud Healthcare API im Google Cloud Projekt.

  4. Konfigurieren Sie die erforderlichen Rollen und Berechtigungen, um diese Aufgabe auszuführen. Sie benötigen die Rolle „Healthcare FHIR Resource Reader“ (roles/healthcare.fhirResourceReader) und die Rolle „Healthcare DICOM Viewer“ (roles/healthcare.dicomViewer) oder entsprechende IAM-Berechtigungen, um eine Verbindung zum Projekt herzustellen.

  5. Konfigurieren Sie Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) für Ihre Umgebung.

MCP-Toolbox installieren

Die Toolbox fungiert als Open-Source- Model Context Protocol (MCP) Server zwischen Ihrer IDE und der Cloud Healthcare API und bietet eine sichere und effiziente Steuerungsebene für Ihre KI-Tools.

  1. Laden Sie die aktuelle Version der MCP Toolbox als Binärprogramm herunter. Wählen Sie das Binärprogramm aus, das Ihrem Betriebssystem und Ihrer CPU-Architektur entspricht. Sie müssen die MCP Toolbox-Version v0.19.1 oder höher verwenden:

    linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    Ersetzen Sie VERSION durch die MCP Toolbox-Version, z. B. v0.19.1.

    macOS darwin/arm64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

    Ersetzen Sie VERSION durch die MCP Toolbox-Version, z. B. v0.19.1.

    macOS darwin/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

    Ersetzen Sie VERSION durch die MCP Toolbox-Version, z. B. v0.19.1.

    windows/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

    Ersetzen Sie VERSION durch die MCP Toolbox-Version, z. B. v0.19.1.

  2. So machen Sie die Binärdatei ausführbar:

    chmod +x toolbox

  3. Installation prüfen:

    ./toolbox --version

Clients und Verbindungen einrichten

In diesem Abschnitt wird erläutert, wie Sie die Cloud Healthcare API mit Ihren Tools verbinden.

Claude-Code

  1. Installieren Sie Claude Code.
  2. Erstellen Sie im Stammverzeichnis Ihres Projekts eine 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 sie: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Starten Sie Claude Code neu, um die neuen Einstellungen zu laden. Wenn das Tool wieder geöffnet wird, wird angezeigt, dass der konfigurierte MCP-Server erkannt wurde.

Claude für den Computer

  1. Öffnen Sie Claude für den Computer und rufen Sie die Einstellungen auf.
  2. Klicken 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 sie: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Starten Sie Claude für den Computer neu.
  5. Auf dem neuen Chatbildschirm wird ein Hammersymbol (MCP) mit dem neuen MCP Server angezeigt.

Cline

  1. Öffnen Sie die Cline-Erweiterung in VS Code und tippen Sie auf das Symbol MCP-Server.
  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 sie: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Nachdem die Verbindung zum Server hergestellt wurde, 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 sie: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Öffnen Sie Cursor und rufen Sie Einstellungen > Cursor-Einstellungen > MCP auf. Wenn die Verbindung zum Server hergestellt wird, wird ein grüner aktiver Status angezeigt.

Visual Studio Code (Copilot)

  1. Öffnen Sie VS Code und erstellen Sie im Stammverzeichnis Ihres Projekts das Verzeichnis .vscode, 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 sie: 
            {
          "servers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Aktualisieren Sie das VS Code-Fenster. Die MCP-kompatible Erweiterung erkennt die Konfiguration automatisch erkennt die Konfiguration automatisch und startet den Server.

Windsurf

  1. Öffnen Sie Windsurf und rufen Sie den Cascade-Assistenten auf.
  2. Klicken 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 sie: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }

          }
        }

Hinweis: Die HEALTHCARE_PROJECT Umgebungsvariable gibt die Standard Google Cloud Projekt-ID an, die von der MCP Toolbox verwendet werden soll. Alle Vorgänge, z. B. die Suche nach Patienten oder das Suchen nach DICOM-Instanzen, werden in diesem Projekt ausgeführt.

Tools verwenden

Ihr KI-Tool ist jetzt über MCP mit der Cloud Healthcare API verbunden. Bitten Sie Ihren KI-Assistenten, nach FHIR-Patienten zu suchen, Datensätze für einen bestimmten Patienten abzurufen, eine DICOM-Studie zu suchen oder die DICOM-Speicher im Dataset aufzulisten.

Dem LLM stehen die folgenden Tools zur Verfügung:

  • get_dataset: Ruft die Details eines Datasets ab.
  • list_datasets: Listet Gesundheitsdatensätze in einem Projekt auf.
  • list_fhir_stores: Listet die FHIR-Speicher im angegebenen Dataset auf.
  • list_dicom_stores: Listet die DICOM-Speicher im angegebenen Dataset auf.
  • get_fhir_store: Ruft die Konfiguration des angegebenen FHIR-Speichers ab.
  • get_fhir_store_metrics: Ruft Messwerte ab, die mit dem FHIR-Speicher verknüpft sind.
  • get_fhir_resource: Ruft den Inhalt einer FHIR-Ressource ab.
  • get_fhir_resource_version: Ruft den Inhalt einer Version (aktuell oder historisch) einer FHIR-Ressource ab.
  • fhir_patient_everything: Ruft eine FHIR-Patientenressource und mit dem relevanten Patienten verbundene Ressourcen ab.
  • fhir_patient_search: Sucht im FHIR-Speicher nach FHIR-Patientenressourcen gemäß den angegebenen Kriterien.
  • get_dicom_store: Ruft die Konfiguration des angegebenen DICOM-Speichers ab.
  • get_dicom_store_metrics: Ruft Messwerte ab, die mit dem DICOM-Speicher verknüpft sind.
  • search_dicom_studies: Gibt eine Liste übereinstimmender DICOM-Studien zurück.
  • search_dicom_series: Gibt eine Liste übereinstimmender DICOM-Serien zurück.
  • search_dicom_instances: Gibt eine Liste übereinstimmender DICOM-Instanzen zurück.
  • retrieve_dicom_instance_rendered: Gibt eine Base64-Codierung eines gerenderten Bilds im JPEG-Format für eine DICOM-Instanz zurück, die mit der angegebenen Studie, Serie und SOP-Instanz-UID verknüpft ist.