Atención al agente

Agent Care: un servidor MCP para EMR como Cerner y Epic

Un servidor de Protocolo de Contexto Modelo (MCP) que proporciona herramientas de atención médica y avisos para interactuar con datos FHIR y recursos médicos en EMR como Cerner y Epic utilizando Claude Desktop y Goose Desktop.

Manifestación

Características

Integración de EMR mediante SMART en las API de FHIR
Utiliza OAuth2 para autenticarse con EMR
Integración de Anthropic Claude Desktop
Integración de la investigación médica (PubMed, ensayos clínicos, FDA)
Almacenamiento en caché de respuestas
Manejo de errores
Formato de datos seguro para valores nulos
Análisis clínico completo

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

Configuración de desarrollo

Para usar con Cerener: Vaya a https://code-console.cerner.com y cree una cuenta de sandbox, cree una nueva aplicación de proveedor y obtenga el ID de cliente/secreto. (Nota: ec2458f2-1e24-41c8-b71b-0e701af7583d a continuación es el ID de inquilino para el sandbox de desarrolladores de Cerner)
Para usar con Epic: vaya a https://fhir.epic.com/Developer/Apps , regístrese como desarrollador, cree una nueva aplicación y obtenga el clientId/secret.
Para PubMed, ensayos clínicos y FDA, debe obtener las claves API de los respectivos sitios web.

Para pruebas locales, cree un archivo .env en el directorio raíz o utilice estas variables de entorno en la configuración de inicio de Claude Desktop.

Cerner

OAUTH_CLIENT_ID="XXXXX",
OAUTH_CLIENT_SECRET="XXXXXXX",
OAUTH_TOKEN_HOST="https://authorization.cerner.com", 
OAUTH_AUTHORIZE_PATH="/tenants/ec2458f2-1e24-41c8-b71b-0e701af7583d/protocols/oauth2/profiles/smart-v1/personas/provider/authorize",
OAUTH_AUTHORIZATION_METHOD='header',
OAUTH_TOKEN_PATH="/tenants/ec2458f2-1e24-41c8-b71b-0e701af7583d/hosts/api.cernermillennium.com/protocols/oauth2/profiles/smart-v1/token",
OAUTH_AUDIENCE="https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d",
OAUTH_CALLBACK_URL="http://localhost:3456/oauth/callback",
OAUTH_SCOPES="user/Patient.read user/Condition.read user/Observation.read user/MedicationRequest.read user/AllergyIntolerance.read user/Procedure.read user/CarePlan.read user/CareTeam.read user/Encounter.read user/Immunization.read",
OAUTH_CALLBACK_PORT="3456"
FHIR_BASE_URL:any = "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d" 
PUBMED_API_KEY=your_pubmed_api_key
CLINICAL_TRIALS_API_KEY=your_trials_api_key
FDA_API_KEY=your_fda_api_key

Épico

OAUTH_CLIENT_ID="XXXXXXX",
OAUTH_CLIENT_SECRET="",
OAUTH_TOKEN_HOST="https://fhir.epic.com",
OAUTH_AUTHORIZE_PATH="/interconnect-fhir-oauth/oauth2/authorize",
OAUTH_AUTHORIZATION_METHOD='body',
OAUTH_TOKEN_PATH="/interconnect-fhir-oauth/oauth2/token",
OAUTH_AUDIENCE="https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4",
OAUTH_CALLBACK_URL="http://localhost:3456/oauth/callback",
OAUTH_SCOPES="user/Patient.read user/Observation.read user/MedicationRequest.read user/Condition.read user/AllergyIntolerance.read user/Procedure.read user/CarePlan.read user/CareTeam.read user/Encounter.read user/Immunization.read",
OAUTH_CALLBACK_PORT=3456
FHIR_BASE_URL:any = "https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4" //EPIC  
PUBMED_API_KEY=your_pubmed_api_key
CLINICAL_TRIALS_API_KEY=your_trials_api_key
FDA_API_KEY=your_fda_api_key

Iniciar el servidor MCP localmente

git clone {agentcare-mcp-github path}
cd agentcare-mcp
npm install
npm run build

Utilice Claude Desktop

for claude desktop: 
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
(use the env variables as shown above)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/Desktop"
      ]
    },
    "agent-care": {
      "command": "node",
      "args": [
        "/Users/your-username/{agentcare-download-path}/agent-care-mcp/build/index.js"
      ],
      "env": {
        "OAUTH_CLIENT_ID": XXXXXX,
        "OAUTH_CLIENT_SECRET":XXXXXXX,
        "OAUTH_TOKEN_HOST":,
        "OAUTH_TOKEN_PATH":,
        "OAUTH_AUTHORIZE_PATH",
        "OAUTH_AUTHORIZATION_METHOD": ,
        "OAUTH_AUDIENCE":,
        "OAUTH_CALLBACK_URL":,
        "OAUTH_SCOPES":,
        "OAUTH_CALLBACK_PORT":,
        "FHIR_BASE_URL":,
        "PUBMED_API_KEY":,
        "CLINICAL_TRIALS_API_KEY":,
        "FDA_API_KEY":
      }
    }
  }
}

Utilice MCP Inspectopr

(Servidor MCP que utiliza el inspector. Asegúrese de actualizar el archivo .env con los valores correctos).

npm install -g @modelcontextprotocol/inspector
mcp-inspector  build/index.js
http://localhost:5173

Inicios de sesión de usuarios de prueba

(comúnmente usado para sandbox/desarrollo)

Cerner: portal | portal
Épico: FHIRTWO | EpicFhir11!

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)

Utilice Goose

Goose es un framework de agente de IA de código abierto de Block (Stripe) compatible con servidores MCP. Goose Desktop, al igual que Claude Desktop, también es compatible con servidores MCP. Sin embargo, Goose también puede configurarse para usar modelos distintos a los antrópicos. Más información: https://block.xyz/inside/block-open-source-introduces-codename-goose

Vea a continuación cómo funciona Goose Desktop con Agent Care: (la extensión Goose se configurará con el comando: /Users/your-username/{agentcare-download-path}/agent-care-mcp/build/index.js)

AgentCare

Integrations