JR360 Clínicas MCP

MCP server para demos y ventas de sistemas de gestión operativa para clínicas en Colombia (y cualquier país hispanohablante).

Construido por JR360 IA Agency LLC como herramienta open-source para la comunidad.

---

¿Qué hace este MCP?

Conecta Claude Desktop (u otro cliente MCP) con 6 herramientas especializadas para demostrar y vender un sistema de control operativo para clínicas médicas, sin depender de ninguna API externa.

Todas las operaciones son 100% locales — sin costos de API, sin latencia, sin configuración compleja.

---

6 Tools disponibles

Tool	Descripción
jr360_get_clinic_context	Contexto completo del sistema: módulos, posicionamiento, precios, demos
jr360_generate_demo_data	Genera pacientes, citas y facturas ficticias personalizadas en COP
jr360_classify_whatsapp	Clasifica intención de mensajes WhatsApp por reglas (sin API)
jr360_generate_daily_report	Reporte ejecutivo diario en markdown para gerencia
jr360_answer_objection	Respuestas comerciales a 12 objeciones frecuentes
jr360_calculate_revenue_loss	Calculadora de fuga de ingresos en COP — argumento de cierre

---

Inicio rápido

Opción A — Local (recomendado para desarrollo)

Requisito: Python 3.10+

git clone https://github.com/jimmyjrengifom-glitch/jr360-clinicas-mcp.git
cd jr360-clinicas-mcp

python3 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -r requirements.txt

python server.py
# Servidor en http://localhost:8080/mcp

Opción B — Docker

docker build -t jr360-clinicas-mcp .
docker run -p 8080:8080 jr360-clinicas-mcp

Opción C — Easypanel / VPS

1. Fork este repositorio
2. En Easypanel → New App → GitHub → seleccionar el fork
3. Variables de entorno:

   MCP_PORT=8080
   MCP_HOST=0.0.0.0
   

4. Activar HTTPS (Traefik automático)
5. Tu servidor queda en https://tu-dominio.easypanel.host/mcp

---

Conectar con Claude Desktop

Abre el archivo de configuración:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega:

{
  "mcpServers": {
    "jr360-clinicas": {
      "url": "http://localhost:8080/mcp",
      "transport": "streamable-http"
    }
  }
}

Reinicia Claude Desktop. Las 6 tools aparecen disponibles automáticamente.

---

Ejemplos de uso en Claude Desktop

Usa jr360_get_clinic_context para darme el posicionamiento completo del sistema.

Usa jr360_generate_demo_data para crear una demo de una clínica dental llamada
"Sonrisa Perfecta" con 10 pacientes.

Clasifica este mensaje de WhatsApp: "Buenas, quiero agendar cita para el martes,
¿tienen disponibilidad?"

Dame la respuesta para esta objeción: "Es muy caro para nosotros"

Calcula la fuga de ingresos para una clínica con 200 pacientes/mes,
25% de ausentismo y ticket promedio de $150.000 COP.

Genera el reporte diario para "Clínica Salud Total" con estos datos:
{"citas_dia": 18, "citas_canceladas": 3, "pacientes_nuevos": 5,
"facturas_pagadas_cop": 1800000, "facturas_pendientes_cop": 450000, "leads_nuevos": 4}

---

Estructura del proyecto

jr360-clinicas-mcp/
├── server.py        # FastMCP — punto de entrada, 6 tools
├── data_store.py    # Datos demo: pacientes, servicios, precios COP por tipo de clínica
├── rule_engine.py   # Clasificador WhatsApp + 12 objeciones con respuestas
├── formatters.py    # Formato COP, reporte diario, calculadora ROI
├── requirements.txt
├── Dockerfile
├── .env.example
└── README.md

---

Stack técnico

• Python 3.10+
• FastMCP (mcp[cli]>=1.9.0) — framework oficial MCP de Anthropic
• Pydantic v2 — validación de parámetros
• Transporte: Streamable HTTP
• Sin dependencias de API externa — todo local

---

Tipos de clínica soportados

dental · estetica · bienestar · quiropraxia · deportiva · general

Cada tipo tiene su propio catálogo de servicios con precios en COP.

---

Adaptar para otro país o moneda

Los datos de data_store.py son fáciles de modificar:

• SERVICIOS_POR_TIPO → cambiar precios a la moneda local
• NOMBRES_PACIENTES / MEDICOS → nombres del mercado objetivo
• En formatters.py → función fmt_cop() → cambiar símbolo y separadores

---

Contribuir

Pull requests bienvenidos. Algunas ideas:

• Agregar más tipos de clínica (oftalmología, pediatría, veterinaria)
• Soporte multi-moneda (MXN, ARS, PEN, CLP)
• Tool para generar propuesta comercial en PDF
• Tool para generar guión de demo personalizado
• Integración con Airtable o Notion como backend real

---

Licencia

MIT — libre para uso personal y comercial.

---

Créditos

Creado por Jimmy Rengifo — JR360 IA Agency LLC

Si este proyecto te fue útil, dale una ⭐ al repositorio.

Para consultas comerciales sobre implementación para tu clínica:

• Web: jr360iaagency.com
• Demo en vivo: jr360-demos.netlify.app