このガイドでは、データベース向け MCP ツールボックスを使用して、Cloud Healthcare API をさまざまな統合開発環境（IDE）とデベロッパー ツールに接続する方法について説明します。Model Context Protocol（MCP）を使用します。これは、大規模言語モデル（LLM）を医療データセットなどのデータソースに接続するためのオープン プロトコルであり、既存のツールから医療データを直接検索して操作できます。
このガイドでは、次の IDE の接続プロセスについて説明します。
- Cursor
- Windsurf（旧 Codeium）
- Visual Studio Code（Copilot）
- Cline（VS Code 拡張機能）
- Claude Desktop
- Claude Code
始める前に
Google Cloud コンソールのプロジェクト セレクタページで、 Google Cloud プロジェクトを選択または作成します。
このタスクを完了するために必要なロールと権限を構成します。プロジェクトに接続するには、Healthcare FHIR リソース閲覧者ロール（
roles/healthcare.fhirResourceReader）と Healthcare DICOM 閲覧者ロール（roles/healthcare.dicomViewer）、または同等の IAM 権限が必要です。使用する環境のアプリケーションのデフォルト認証情報（ADC）を構成します。
MCP ツールボックスをインストールする
このツールボックスは、IDE と Cloud Healthcare API の間に配置されるオープンソースの Model Context Protocol（MCP）サーバーとして機能し、AI ツール用の安全で効率的なコントロール プレーンを提供します。
MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティング システム（OS）と CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックス バージョン v0.19.1 以降を使用する必要があります。
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
VERSIONは、MCP ツールボックスのバージョン（v0.19.1など）に置き換えます。macOS darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
VERSIONは、MCP ツールボックスのバージョン（v0.19.1など）に置き換えます。macOS darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
VERSIONは、MCP ツールボックスのバージョン（v0.19.1など）に置き換えます。windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
VERSIONは、MCP ツールボックスのバージョン（v0.19.1など）に置き換えます。バイナリを実行可能にします。
chmod +x toolboxインストールを確認します。
./toolbox --version
クライアントと接続を設定する
このセクションでは、Cloud Healthcare API をツールに接続する方法について説明します。
Claude Code
- Claude Code をインストールします。
.mcp.jsonファイルが存在しない場合は、プロジェクトのルートに作成します。- 構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - Claude Code を再起動して、新しい設定を読み込みます。ツールを再度開くと、構成された MCP サーバーが検出されたことを示すメッセージが表示されます。
Claude Desktop
- Claude Desktop を開き、[Settings] に移動します。
- [Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
- 構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - Claude Desktop を再起動します。
- 新しいチャット画面に、新しい MCP サーバーのハンマー（MCP）アイコンが表示されます。
Cline
- VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをタップします。
- [Configure MCP Servers] をタップして構成ファイルを開きます。
- 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } }
サーバーが正常に接続されると、緑色のアクティブ ステータスが表示されます。
Cursor
- プロジェクトのルートに
.cursorディレクトリが存在しない場合は作成します。 .cursor/mcp.jsonファイルが存在しない場合は作成してから、それを開きます。- 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "mcpServers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーに接続すると、緑色のアクティブ ステータスが表示されます。
Visual Studio Code（Copilot）
- VS Code を開き、プロジェクトのルートに
.vscodeディレクトリが存在しない場合は作成します。 .vscode/mcp.jsonファイルが存在しない場合は作成してから、それを開きます。- 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "servers": { "healthcare": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-healthcare","--stdio"], "env": { "HEALTHCARE_PROJECT": "PROJECT_ID", "HEALTHCARE_REGION": "REGION", "HEALTHCARE_DATASET": "DATASET_ID" } } } } - VS Code ウィンドウを再読み込みします。MCP 互換の拡張機能が構成を自動的に検出し、サーバーを起動します。
Windsurf
- Windsurf を開き、Cascade アシスタントに移動します。
- MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
- 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
{ "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 ツールボックスで使用するデフォルトの 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 エンコードして返します。