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.

👁 insignia de herrería

Manifestación

👁 Manifestación

Related MCP server: Azure AHDS FHIR MCP Server

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.

  • https://clinicaltrials.gov/api/v2/studies

  • https://eutils.ncbi.nlm.nih.gov/entrez/eutils

  • https://api.fda.gov/drug/ndc.json

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)

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers