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

Un servidor MCP para la API de Google Cloud Healthcare (FHIR)

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas de atención médica para interactuar con recursos FHIR en la API de Google Cloud Healthcare y API de investigación médica pública como pubmed, utilizando clientes MCP como Claude y Goose.

Esta es una versión ligeramente modificada para AgentCare MCP Server para EHR. https://github.com/Kartha-AI/agentcare-mcp

La principal diferencia es que este repositorio se comunica con las API FHIR de Google Cloud Healthcare a través de una puerta de enlace SmartonFHIR protegida por Firebase Auth.

Arquitectura

Manifestación

Claude: demo/claude-demo.mp4
Ganso: demo/goose-demo.mp4

Capturas de pantalla

Herramientas

Herramientas FHIR

find_patient - Busca un paciente por nombre, fecha de nacimiento u otros identificadores
get_patient_observations - Recuperar observaciones/signos vitales del paciente
get_patient_conditions - Obtener las condiciones activas del paciente
get_patient_medications - Obtener los medicamentos actuales del paciente
get_patient_encounters - Obtener los encuentros clínicos del paciente
get_patient_allergies - Obtenga las alergias e intolerancias del paciente
get_patient_procedures - Obtener los procedimientos del paciente
get_patient_careteam - Obtener los miembros del equipo de atención del paciente
get_patient_careplans - Obtener los planes de atención activos del paciente
get_vital_signs - Obtener los signos vitales del paciente
get_lab_results - Obtener los resultados de laboratorio del paciente
get_medications_history - Obtener el historial de medicación del paciente
clinical_query : ejecuta consultas FHIR personalizadas

Herramientas de investigación médica

search-pubmed - Busque artículos de PubMed relacionados con afecciones médicas.
search-trials - Encuentra ensayos clínicos relevantes
drug-interactions - Consultar interacciones medicamentosas

Uso

Cada herramienta requiere parámetros específicos:

Parámetros requeridos

La mayoría de las herramientas requieren patientId
Algunas herramientas tienen parámetros adicionales:
- lab_trend_analysis : requiere labType
- search-pubmed : requiere query y maxResults opcional
- search-trials : requiere condition y location opcional
- drug-interactions : requiere una matriz drugs

Consulte: /src/server/constants/tools.ts para obtener la especificación de las herramientas

Usar con Claude Desktop

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"
      }
    }
  }
}

Instalación mediante herrería

Para instalar google-cloud-healthcare-api-mcp para Claude Desktop automáticamente a través de Smithery :

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

Iniciar el servidor MCP localmente con MCP Inspector

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

Solución de problemas:

Si el escritorio Claude se está ejecutando, usa el puerto 3456 para la autenticación. Debe finalizar ese proceso con el siguiente comando:

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

El servidor MCP para la API de Google Cloud Healthcare permite la inteligencia artificial de Agentic para una variedad de soluciones de salud digital basadas en FHIR, desde flujos de trabajo clínicos más inteligentes para sistemas de salud hasta marcos de preautorización para pagadores.

Related Resources

Reddit Discussion about this server

MCP Server for Google Cloud Healthcare API