Usa la API de Cloud Healthcare con MCP y otros agentes

En esta guía, se muestra cómo usar MCP Toolbox para bases de datos para conectar la API de Cloud Healthcare a una variedad de entornos de desarrollo integrado (IDE) y herramientas para desarrolladores. Usa el Protocolo de contexto del modelo (MCP), un protocolo abierto para conectar modelos de lenguaje grandes (LLM) a fuentes de datos, como conjuntos de datos de atención médica, lo que te permite buscar datos de atención médica y, también, interactuar con ellos directamente desde tus herramientas existentes.

En esta guía, se demuestra el proceso de conexión para los siguientes IDE:

  • Cursor
  • Windsurf (antes conocido como Codeium)
  • Visual Studio Code (Copilot)
  • Cline (extensión de VS Code)
  • Claude para computadoras de escritorio
  • Claude Code

Antes de comenzar

  1. En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.

  2. Asegúrate de tener habilitada la facturación para tu Google Cloud proyecto.

  3. Habilita la API de Cloud Healthcare en el Google Cloud proyecto.

  4. Configura los roles y los permisos requeridos para completar esta tarea. Necesitarás el rol de Lector de recursos FHIR de Healthcare (roles/healthcare.fhirResourceReader) y el rol de Visualizador de DICOM de Healthcare (roles/healthcare.dicomViewer) o permisos equivalentes de IAM para conectarte al proyecto.

  5. Configura las credenciales predeterminadas de la aplicación (ADC) para tu entorno.

Instala MCP Toolbox

La caja de herramientas actúa como un servidor de Protocolo de contexto del modelo (MCP) código abierto que se encuentra entre tu IDE y la API de Cloud Healthcare, lo que proporciona un plano de control seguro y eficiente para tus herramientas de IA.

  1. Descarga la versión más reciente de MCP Toolbox como un objeto binario. Selecciona el objeto binario correspondiente a tu sistema operativo (SO) y arquitectura de la CPU. Debes usar la versión v0.19.1 o posterior de MCP Toolbox:

    linux/amd64

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

    Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.19.1.

    macOS darwin/arm64

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

    Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.19.1.

    macOS darwin/amd64

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

    Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.19.1.

    windows/amd64

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

    Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.19.1.

  2. Haz que el objeto binario sea ejecutable:

    chmod +x toolbox

  3. Verifica la instalación:

    ./toolbox --version

Configura clientes y conexiones

En esta sección, se explica cómo conectar la API de Cloud Healthcare a tus herramientas.

Claude Code

  1. Instala Claude Code.
  2. Crea un archivo .mcp.json en la raíz de tu proyecto, si no existe.
  3. Agrega la configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Reinicia Claude Code para cargar la configuración nueva. Cuando se vuelva a abrir, la herramienta indicará que se detectó el servidor de MCP configurado.

Claude para computadoras de escritorio

  1. Abre Claude para computadoras de escritorio y navega a Configuración.
  2. En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.
  3. Agrega la configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Reinicia Claude para computadoras de escritorio.
  5. En la nueva pantalla de chat, se muestra un ícono de martillo (MCP) con el nuevo servidor de MCP.

Cline

  1. Abre la extensión de Cline en VS Code y presiona el ícono de servidores de MCP.
  2. Presiona Configurar servidores de MCP para abrir el archivo de configuración.
  3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Aparecerá un estado activo verde después de que el servidor se conecte correctamente.

Cursor

  1. Crea el directorio .cursor en la raíz de tu proyecto si no existe.
  2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
  3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Abre Cursor y navega a Configuración > Configuración del cursor > MCP. Aparecerá un estado activo verde cuando el servidor se conecte.

Visual Studio Code (Copilot)

  1. Abre VS Code y crea un directorio .vscode en la raíz de tu proyecto si no existe.
  2. Crea el archivo .vscode/mcp.json si no existe y ábrelo.
  3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "servers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. Vuelve a cargar la ventana de VS Code. La extensión compatible con MCP detecta automáticamente la configuración y, luego, inicia el servidor.

Windsurf

  1. Abre Windsurf y navega al asistente de Cascade.
  2. Haz clic en el ícono de MCP y, luego, en Configurar para abrir el archivo de configuración.
  3. Agrega la siguiente configuración, reemplaza las variables de entorno por tus valores y guarda: 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }

          }
        }

Nota: La variable de entorno HEALTHCARE_PROJECT especifica el ID del proyecto predeterminado Google Cloud Project que usará MCP Toolbox. Todas las operaciones, como buscar pacientes o buscar instancias de DICOM, se ejecutan dentro de este proyecto.

Usa las herramientas

Tu herramienta de IA ahora está conectada a la API de Cloud Healthcare con MCP. Intenta pedirle a tu asistente de IA que busque pacientes de FHIR, recupere registros de un paciente determinado, busque un estudio de DICOM o muestre una lista de los almacenes de DICOM en el conjunto de datos.

Las siguientes herramientas están disponibles para el LLM:

  • get_dataset: Recupera los detalles de un conjunto de datos.
  • list_datasets: Muestra una lista de los conjuntos de datos de salud en un proyecto.
  • list_fhir_stores: Muestra una lista de los almacenes de FHIR en el conjunto de datos determinado.
  • list_dicom_stores: Muestra una lista de los almacenes de DICOM en el conjunto de datos determinado.
  • get_fhir_store: Obtiene la configuración del almacén de FHIR especificado.
  • get_fhir_store_metrics: Obtiene las métricas asociadas con el almacén de FHIR.
  • get_fhir_resource: Obtiene el contenido de un recurso de FHIR.
  • get_fhir_resource_version: Obtiene el contenido de una versión (actual o histórica) de un recurso de FHIR.
  • fhir_patient_everything: Recupera un recurso de paciente de FHIR y los recursos relacionados con ese paciente.
  • fhir_patient_search: Busca recursos de pacientes de FHIR en el almacén de FHIR según los criterios especificados.
  • get_dicom_store: Obtiene la configuración del almacén de DICOM especificado.
  • get_dicom_store_metrics: Obtiene las métricas asociadas con el almacén de DICOM.
  • search_dicom_studies: Muestra una lista de estudios de DICOM coincidentes.
  • search_dicom_series: Muestra una lista de series de DICOM coincidentes.
  • search_dicom_instances: Muestra una lista de instancias de DICOM coincidentes.
  • retrieve_dicom_instance_rendered: Muestra una codificación en base64 de una imagen renderizada en formato JPEG para una instancia de DICOM asociada con el estudio, la serie y el UID de instancia SOP determinados.