Medical MCP Server - Yari System

Servidor MCP (Model Context Protocol) para el sistema médico Yari Medic.
147 herramientas médicas expuestas vía protocolo MCP (SSE).

Inicio Rápido

# Instalar dependencias
npm install

# Copiar configuración
cp .env.example .env

# Iniciar en modo desarrollo
npm run dev

# Iniciar en producción
npm start

Requisitos

• Node.js >= 18
• npm >= 10
• Django API (yarimedic.io) accesible

Arquitectura

Yari Medic Ecosystem (v6.4)
┌─────────────────────────────────────────────┐
│              Railway Cloud                  │
│                                             │
│  ┌───────────────┐    ┌──────────────────┐  │
│  │ yari-ai-agent │───►│ medical-mcp-     │  │
│  │ (ZeroClaw)    │HTTP│ server           │  │
│  │ Rust          │    │ Node.js/Express  │  │
│  │ Port: 8080    │    │ Port: 9000       │  │
│  └───────────────┘    └────────┬─────────┘  │
│                                │             │
│                     ┌──────────▼──────────┐  │
│                     │  yarimedic.io       │  │
│                     │  (Django Backend)   │  │
│                     │  Port: 8000         │  │
│                     └─────────────────────┘  │
└─────────────────────────────────────────────┘

• Repo: Yari-Medic/yari-medic-mcp
• Railway Project: yari-medic-mcp
• Service: medical-mcp-server
• URL pública: https://medical-mcp-server-production.up.railway.app
• Health check: GET /health

Configuración

Edita el archivo .env con tus configuraciones:

PORT=9000
DJANGO_API_URL=https://www.yarimedic.io
GEMINI_API_KEY=tu-api-key
GROQ_API_KEY=tu-api-key
REDIS_URL=redis://...

Endpoints

• GET / - Health check
• GET /health - Status detallado
• POST /mcp - Endpoint MCP principal (SSE)

Herramientas MCP (147 total)

Pacientes

• get_patient_by_id - Obtener paciente por ID
• get_patient_history - Historial clínico
• get_patient_appointments - Citas del paciente
• get_patient_invoices - Facturas del paciente
• get_patient_ecografias - Ecografías del paciente
• analyze_patient_comprehensive - Análisis integral con IA

Médicos y Citas

• get_available_doctors - Médicos disponibles
• schedule_appointment - Agendar cita
• search_medical_directory - Directorio médico

Farmacia

• get_pharmacy_inventory - Inventario farmacéutico
• search_medications - Búsqueda de medicamentos
• check_stock - Verificar stock

Laboratorio

• get_lab_results - Resultados de laboratorio
• search_lab_tests - Catálogo de pruebas
• request_lab_test - Solicitar prueba

Facturación

• get_accounts_receivable - Cuentas por cobrar
• get_accounts_payable - Cuentas por pagar
• get_receivable_documents - Documentos de cobro
• get_payable_documents - Documentos de pago

CRM

• get_crm_cases - Casos CRM
• get_medical_stats - Estadísticas médicas

Emergencias y Triage

• get_emergency_cases - Casos de emergencia
• request_emergency_service - Solicitar servicio de emergencia
• get_hospitalization_status - Estado de hospitalización
• get_fleet_status - Estado de flota de ambulancias

Chat

• chat - Chat con protocolo Manchester (triage ATINMCA)

Ver src/tools.ts para la lista completa de 147 herramientas.

Docker

# Build
docker build -t medical-mcp-server .

# Run
docker run -p 9000:9000 \
  -e DJANGO_API_URL=https://www.yarimedic.io \
  -e GEMINI_API_KEY=... \
  -e GROQ_API_KEY=... \
  -e REDIS_URL=... \
  medical-mcp-server

Desarrollo

# Build TypeScript
npm run build

# Watch mode
npm run watch

# Tests
npm test

Documentación

Ver docs/ para documentación adicional.