将 Cloud Healthcare API 与 MCP 和其他代理搭配使用

本指南介绍了如何使用 MCP Toolbox for Databases 将 Cloud Healthcare API 连接到各种集成开发环境 (IDE) 和开发者工具。它使用 Model Context Protocol (MCP)，这是一种开放协议，用于将大语言模型 (LLM) 连接到医疗保健数据集等数据源，让您能够直接通过现有工具搜索医疗保健数据并与之互动。

本指南演示了适用于以下 IDE 的连接过程：

  • 光标
  • Windsurf（以前称为 Codeium）
  • Visual Studio Code (Copilot)
  • Cline（VS Code 扩展程序）
  • Claude Desktop
  • Claude Code

准备工作

  1. 在 Google Cloud 控制台的项目选择器页面上，选择或创建 Google Cloud 项目。

  2. 确保您的 Google Cloud 项目已启用结算功能。

  3. 在 Google Cloud 项目中启用 Cloud Healthcare API。

  4. 配置完成此任务所需的角色和权限。您需要拥有 Healthcare FHIR Resource Reader 角色 (roles/healthcare.fhirResourceReader) 和 Healthcare DICOM Viewer 角色 (roles/healthcare.dicomViewer)，或等效的 IAM 权限才能连接到项目。

  5. 为您的环境配置应用默认凭证 (ADC)。

安装 MCP Toolbox

该工具箱充当位于 IDE 和 Cloud Healthcare API 之间的开源 Model Context Protocol (MCP) 服务器，为 AI 工具提供安全高效的控制平面。

  1. 以二进制文件形式下载最新版本的 MCP Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 MCP Toolbox v0.19.1 版或更高版本：

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox

    将 VERSION 替换为 MCP Toolbox 版本，例如 v0.19.1。

    macOS darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox

    将 VERSION 替换为 MCP Toolbox 版本，例如 v0.19.1。

    macOS darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox

    将 VERSION 替换为 MCP Toolbox 版本，例如 v0.19.1。

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox

    将 VERSION 替换为 MCP Toolbox 版本，例如 v0.19.1。

  2. 将该二进制文件设为可执行文件：

    chmod +x toolbox

  3. 验证安装：

    ./toolbox --version

设置客户端和连接

本部分介绍如何将 Cloud Healthcare API 连接到您的工具。

Claude Code

  1. 安装 Claude Code。
  2. 在项目根目录中创建 .mcp.json 文件（如果尚不存在）。
  3. 添加配置，将环境变量替换为您的值，然后保存： 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. 重启 Claude Code 以加载新设置。重新打开该工具后，其会指示已检测到配置的 MCP 服务器。

Claude Desktop

  1. 打开 Claude Desktop，然后前往设置。
  2. 在开发者标签页中，点击修改配置以打开配置文件。
  3. 添加配置，将环境变量替换为您的值，然后保存： 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. 重启 Claude Desktop。
  5. 新聊天界面会显示锤子 (MCP) 图标以及新的 MCP 服务器。

Cline

  1. 在 VS Code 中打开 Cline 扩展程序，然后点按 MCP 服务器图标。
  2. 点按配置 MCP 服务器以打开配置文件。
  3. 添加以下配置，将环境变量替换为您的值，然后保存： 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

服务器成功连接后，系统会显示绿色的活跃状态。

光标

  1. 在项目根目录中创建 .cursor 目录（如果尚不存在）。
  2. 创建 .cursor/mcp.json 文件（如果尚不存在）并打开该文件。
  3. 添加以下配置，将环境变量替换为您的值，然后保存： 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. 打开 Cursor，然后依次前往设置 > Cursor 设置 > MCP。服务器连接时，系统会显示绿色的活跃状态。

Visual Studio Code (Copilot)

  1. 打开 VS Code，并在项目根目录中创建 .vscode 目录（如果尚不存在）。
  2. 创建 .vscode/mcp.json 文件（如果尚不存在）并打开该文件。
  3. 添加以下配置，将环境变量替换为您的值，然后保存： 
            {
          "servers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }
  4. 重新加载 VS Code 窗口。兼容 MCP 的扩展程序会自动检测配置并启动服务器。

Windsurf

  1. 打开 Windsurf 并前往 Cascade 助理。
  2. 点击 MCP 图标，然后点击配置以打开配置文件。
  3. 添加以下配置，将环境变量替换为您的值，然后保存： 
            {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }

          }
        }

注意：HEALTHCARE_PROJECT 环境变量用于指定 MCP Toolbox 将使用的默认 Google Cloud 项目的 ID。所有操作（例如搜索患者或查找 DICOM 实例）都在此项目中运行。

使用这些工具

您的 AI 工具现在已使用 MCP 连接到 Cloud Healthcare API。您可以尝试让 AI 助理搜索 FHIR 患者、检索指定患者的记录、查找 DICOM 研究或列出数据集中的 DICOM 存储区。

LLM 可使用以下工具：

  • get_dataset：检索数据集的详细信息。
  • list_datasets：列出项目中的健康数据集。
  • list_fhir_stores：列出给定数据集中的 FHIR 存储区。
  • list_dicom_stores：列出给定数据集中的 DICOM 存储区。
  • get_fhir_store：获取指定 FHIR 存储区的配置。
  • get_fhir_store_metrics：获取与 FHIR 存储区关联的指标。
  • get_fhir_resource：获取 FHIR 资源的内容。
  • get_fhir_resource_version：获取 FHIR 资源的版本（当前版本或历史版本）的内容。
  • fhir_patient_everything：检索 FHIR 患者资源以及与该患者相关的资源。
  • fhir_patient_search：根据指定的条件在 FHIR 存储区中搜索 FHIR 患者资源。
  • get_dicom_store：获取指定 DICOM 存储区的配置。
  • get_dicom_store_metrics：获取与 DICOM 存储区关联的指标。
  • search_dicom_studies：返回匹配的 DICOM 研究列表。
  • search_dicom_series：返回匹配的 DICOM 系列的列表。
  • search_dicom_instances：返回匹配的 DICOM 实例的列表。
  • retrieve_dicom_instance_rendered：返回与指定研究、序列和 SOP 实例 UID 关联的 DICOM 实例的 JPEG 格式渲染图片的 base64 编码。