MCP Server for Google Cloud Healthcare API

by Kartha-AI
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Uses Firebase Authentication to secure access to the FHIR gateway and healthcare data

  • Interfaces with Google Cloud Healthcare API to access and query FHIR healthcare resources including patient data, observations, conditions, medications, and clinical records

  • Enables searching of PubMed medical research articles related to specific conditions or topics

Google Cloud Healthcare API (FHIR) 用の MCP サーバー

Claude や Goose などの MCP クライアントを使用して、 Google Cloud Healthcare API上の FHIR リソースや pubmed などの公開医療研究 API とやり取りするためのヘルスケア ツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。

これは、EHR 用の AgentCare MCP Server の若干変更されたバージョンです。https ://github.com/Kartha-AI/agentcare-mcp

主な違いは、このリポジトリは Firebase Auth によって保護された SmartonFHIR ゲートウェイを介して Google Cloud Healthcare FHIR API と通信することです。

建築

デモ

  • クロード: demo/claude-demo.mp4
  • ガチョウ: demo/goose-demo.mp4

スクリーンショット

ツール

FHIRツール

  • find_patient - 名前、生年月日、その他の識別子で患者を検索します
  • get_patient_observations - 患者の観察/バイタルサインを取得する
  • get_patient_conditions - 患者の現在の状態を取得する
  • get_patient_medications - 患者の現在の薬を取得する
  • get_patient_encounters - 患者の臨床診療情報を取得する
  • get_patient_allergies - 患者のアレルギーや不耐性を取得する
  • get_patient_procedures - 患者の処置を取得する
  • get_patient_careteam - 患者のケアチームのメンバーを取得する
  • get_patient_careplans - 患者のアクティブなケアプランを取得する
  • get_vital_signs - 患者のバイタルサインを取得する
  • get_lab_results - 患者の検査結果を取得する
  • get_medications_history - 患者の投薬履歴を取得する
  • clinical_query - カスタム FHIR クエリを実行します

医療研究ツール

  • search-pubmed - 病状に関連するPubMed記事を検索
  • search-trials - 関連する臨床試験を検索する
  • drug-interactions - 薬物相互作用をチェックする

使用法

各ツールには特定のパラメータが必要です。

必須パラメータ

  • ほとんどのツールではpatientIdが必要です
  • 一部のツールには追加のパラメータがあります。
    • lab_trend_analysis : labTypeが必要です
    • search-pubmed : queryとオプションのmaxResultsが必要です
    • search-trials : conditionが必要で、 locationオプション
    • drug-interactions : drugs配列が必要です

ツールの仕様については、/src/server/constants/tools.ts を参照してください。

クロードデスクトップで使用する

for claude desktop: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json (use the env variables as shown above) { "mcpServers": { "google-cloud-healthcare-api-mcp": { "command": "node", "args": [ "/Users/your-username/{google-cloud-healthcare-api-mcp dir}/build/index.js" ], "env": { "FIREBASE_API_KEY":"XXXXXXXXX", "FIREBASE_AUTH_DOMAIN":"XXXXXXXX", "FIREBASE_PROJECT_ID":"XXXXXXX", "FIREBASE_STORAGE_BUCKET":"XXXXXXXXX", "FIREBASE_MESSAGING_SENDER_ID":"XXXXXXX", "FIREBASE_APP_ID":"XXXXXXXXX", "FIREBASE_MEASUREMENT_ID":"XXXXXXXX", "FIREBASE_AUTH_CALLBACK_PORT":"3456", "FHIR_BASE_URL":"{gchapi-fhir-gateway-host}/fhir", "PUBMED_API_KEY":"your_pubmed_api_key", "CLINICAL_TRIALS_API_KEY":"your_trials_api_key", "FDA_API_KEY":"your_fda_api_key" } } } }

Smithery経由でインストール

Smithery経由で Claude Desktop 用の google-cloud-healthcare-api-mcp を自動的にインストールするには:

npx -y @smithery/cli install @Kartha-AI/google-cloud-healthcare-api-mcp --client claude

MCP Inspector を使用して MCP サーバーをローカルで起動する

git clone git@github.com:Kartha-AI/google-cloud-healthcare-api-mcp.git cd google-cloud-healthcare-api-mcp npm install npm run build npm install -g @modelcontextprotocol/inspector mcp-inspector build/index.js http://localhost:5173 Set up the env vars on Inspector

トラブルシューティング:

Claudeデスクトップが実行中の場合、認証にポート3456を使用します。以下のコマンドを使用して、そのプロセスを終了してください。

kill -9 $(lsof -t -i:3456)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Google Cloud Healthcare API 用の MCP サーバーにより、医療システム向けのよりスマートな臨床ワークフローから保険者向けの事前承認フレームワークまで、さまざまな FHIR ベースのデジタル ヘルス ソリューションで Agentic AI が利用できるようになります。

  1. Architetcure
    1. Demo
      1. Screenshots
        1. Tools
          1. FHIR Tools
          2. Medical Research Tools
        2. Usage
          1. Required Parameters
        3. Use with claude desktop
          1. Installing via Smithery
        4. Start MCP Server Locally with MCP Inspector
          1. Troubleshooting:
            ID: e6dzbv6yl8