搭配使用 Cloud Healthcare API 與 MCP 和其他代理程式

本指南說明如何使用 MCP Toolbox for Databases，將 Cloud Healthcare API 連線至各種整合開發環境 (IDE) 和開發人員工具。這項工具採用 Model Context Protocol (MCP)，這是一項開放式通訊協定，可將大型語言模型 (LLM) 連線至醫療保健資料集等資料來源，讓您直接透過現有工具搜尋及處理醫療保健資料。

本指南將示範下列 IDE 的連線程序：

  • Cursor
  • Windsurf (原名 Codeium)
  • Visual Studio Code (Copilot)
  • Cline (VS Code 擴充功能)
  • Claude 電腦版
  • Claude 代碼

事前準備

  1. 在 Google Cloud 控制台的專案選擇器頁面中，選取或建立 Google Cloud 專案。

  2. 確認您已為 Google Cloud 專案啟用計費功能。

  3. 在 Google Cloud 專案中啟用 Cloud Healthcare API。

  4. 設定完成這項工作所需的角色和權限。如要連線至專案，您需要「Healthcare FHIR 資源讀取者」角色 (roles/healthcare.fhirResourceReader) 和「Healthcare DICOM 檢視者」角色 (roles/healthcare.dicomViewer)，或同等 IAM 權限。

  5. 為環境設定應用程式預設憑證 (ADC)。

安裝 MCP Toolbox

這個工具箱是開放原始碼的模型上下文協定 (MCP) 伺服器，位於 IDE 和 Cloud Healthcare API 之間，可為 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 代碼

  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 電腦版

  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 Servers」圖示。
  2. 輕觸「Configure MCP Servers」(設定 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"
              }
            }
          }
        }

伺服器連線成功後，會顯示綠色的「有效」狀態。

Cursor

  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. 開啟「游標」，然後依序前往「設定」>「游標設定」>「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 相容擴充功能會自動偵測設定並啟動伺服器。

滑浪風帆

  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 Patient 資源和與該病患相關的資源。
  • 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 編碼。