Cette page a été traduite par l'API Cloud Translation.

Utiliser l'API Cloud Healthcare avec MCP et d'autres agents

Ce guide vous explique comment utiliser MCP Toolbox for Databases pour connecter l'API Cloud Healthcare à divers environnements de développement intégrés (IDE) et outils pour les développeurs. Il utilise le Model Context Protocol (MCP), un protocole ouvert permettant de connecter des grands modèles de langage (LLM) à des sources de données telles que des ensembles de données de santé. Vous pouvez ainsi rechercher des données de santé et interagir avec elles directement depuis vos outils existants.

Ce guide explique comment connecter les IDE suivants :

Cursor
Windsurf (anciennement Codeium)
Visual Studio Code (Copilot)
Cline (extension VS Code)
Claude sur ordinateur
Code Claude

Avant de commencer

Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .
Assurez-vous que la facturation est activée pour votre projet Google Cloud .
Activez l'API Cloud Healthcare dans le projet Google Cloud .
Configurez les rôles et autorisations requis pour effectuer cette tâche. Vous aurez besoin du rôle Lecteur de ressources FHIR Healthcare (roles/healthcare.fhirResourceReader) et du rôle Lecteur DICOM Healthcare (roles/healthcare.dicomViewer), ou d'autorisations IAM équivalentes, pour vous connecter au projet.
Configurez les identifiants par défaut de l'application pour votre environnement.

Installer MCP Toolbox

Cette boîte à outils agit comme un serveur MCP (Model Context Protocol) Open Source qui se situe entre votre IDE et l'API Cloud Healthcare. Elle fournit un plan de contrôle sécurisé et efficace pour vos outils d'IA.

Téléchargez la dernière version de MCP Toolbox en tant que binaire. Sélectionnez le binaire correspondant à votre système d'exploitation et à l'architecture de votre processeur. Vous devez utiliser la version v0.19.1 ou ultérieure de MCP Toolbox :
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
Remplacez VERSION par la version de MCP Toolbox, par exemple v0.19.1.
macOS darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
Remplacez VERSION par la version de MCP Toolbox, par exemple v0.19.1.
macOS darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
Remplacez VERSION par la version de MCP Toolbox, par exemple v0.19.1.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
Remplacez VERSION par la version de MCP Toolbox, par exemple v0.19.1.
Rendez le binaire exécutable :
```
chmod +x toolbox
```
Vérifiez l'installation :
```
./toolbox --version
```

Configurer les clients et les connexions

Cette section explique comment connecter l'API Cloud Healthcare à vos outils.

Code Claude

Installez Claude Code.
Créez un fichier .mcp.json à la racine de votre projet, s'il n'existe pas.

Ajoutez la configuration, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Redémarrez Claude Code pour charger les nouveaux paramètres. Lorsqu'il se rouvre, l'outil indique que le serveur MCP configuré a été détecté.

Claude sur ordinateur

Ouvrez Claude Desktop et accédez à Settings (Paramètres).
Dans l'onglet Développeur, cliquez sur Modifier la configuration pour ouvrir le fichier de configuration.

Ajoutez la configuration, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Redémarrez Claude Desktop.
Le nouvel écran de chat affiche une icône en forme de marteau (MCP) avec le nouveau serveur MCP.

Cline

Ouvrez l'extension Cline dans VS Code, puis appuyez sur l'icône Serveurs MCP.
Appuyez sur Configurer les serveurs MCP pour ouvrir le fichier de configuration.

Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Un état actif vert s'affiche une fois que le serveur est connecté.

Cursor

Créez le répertoire .cursor dans la racine de votre projet s'il n'existe pas.
Créez le fichier .cursor/mcp.json s'il n'existe pas et ouvrez-le.

Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Ouvrez Cursor, puis accédez à Settings > Cursor Settings > MCP. Un état actif vert s'affiche lorsque le serveur se connecte.

Visual Studio Code (Copilot)

Ouvrez VS Code et créez un répertoire .vscode dans la racine de votre projet s'il n'existe pas.
Créez le fichier .vscode/mcp.json s'il n'existe pas, puis ouvrez-le.

Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "servers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Actualisez la fenêtre VS Code. L'extension compatible avec MCP détecte automatiquement la configuration et démarre le serveur.

Windsurf

Ouvrez Windsurf et accédez à l'assistant Cascade.
Cliquez sur l'icône MCP, puis sur Configurer pour ouvrir le fichier de configuration.

Ajoutez la configuration suivante, remplacez les variables d'environnement par vos valeurs et enregistrez :

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }

          }
        }

Remarque : La variable d'environnement HEALTHCARE_PROJECT spécifie l'ID de projet Google Cloud par défaut que MCP Toolbox doit utiliser. Toutes les opérations, comme la recherche de patients ou la consultation d'instances DICOM, sont exécutées dans ce projet.

Utiliser les outils

Votre outil d'IA est désormais connecté à l'API Cloud Healthcare à l'aide de MCP. Essayez de demander à votre assistant IA de rechercher des patients FHIR, de récupérer des dossiers pour un patient donné, de rechercher une étude DICOM ou de lister les magasins DICOM dans l'ensemble de données.

Les outils suivants sont à la disposition du LLM :

get_dataset : récupère les détails d'un ensemble de données.
list_datasets : liste les ensembles de données de santé d'un projet.
list_fhir_stores : liste les FHIR Stores dans l'ensemble de données spécifié.
list_dicom_stores : répertorie les magasins DICOM dans l'ensemble de données spécifié.
get_fhir_store : obtient la configuration du store FHIR spécifié.
get_fhir_store_metrics : récupère les métriques associées au magasin FHIR.
get_fhir_resource : obtient le contenu d'une ressource FHIR.
get_fhir_resource_version : récupère le contenu d'une version (actuelle ou historique) d'une ressource FHIR.
fhir_patient_everything : récupère une ressource Patient FHIR et les ressources associées à ce patient.
fhir_patient_search : recherche des ressources FHIR de patient dans le magasin FHIR en fonction des critères spécifiés.
get_dicom_store : obtient la configuration du magasin DICOM spécifié.
get_dicom_store_metrics : obtient les métriques associées au magasin DICOM.
search_dicom_studies : renvoie la liste des études DICOM correspondantes.
search_dicom_series : renvoie la liste des séries DICOM correspondantes.
search_dicom_instances : renvoie la liste des instances DICOM correspondantes.
retrieve_dicom_instance_rendered : renvoie un encodage en base64 d'une image rendue au format JPEG pour une instance DICOM associée à l'étude, à la série et à l'UID d'instance SOP spécifiés.

Utiliser l'API Cloud Healthcare avec MCP et d'autres agents Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Installer MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Configurer les clients et les connexions

Code Claude

Claude sur ordinateur

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

Utiliser les outils

Utiliser l'API Cloud Healthcare avec MCP et d'autres agents