Uptime Agent

🚀 Uptime Agent MCP Server

Conecta tu sistema de monitoreo Uptime Agent directamente a asistentes de IA como Claude a través del Model Context Protocol (MCP).

✨ Características

• Acceso de Monitoreo en Tiempo Real: Permite a los asistentes de IA verificar el estado de disponibilidad de tu sistema
• Gestión de Incidentes: Visualiza y analiza incidentes de caída mediante conversación natural
• Creación de Monitores: Configura nuevos endpoints de monitoreo con simples comandos de voz o texto
• Integración Segura: Seguridad de nivel empresarial para tu infraestructura de monitoreo

🔍 ¿Qué es Uptime Agent?

Uptime Agent es una potente solución de monitoreo que rastrea tus sitios web y endpoints de API, alertándote cuando se caen. Este servidor MCP extiende las capacidades de Uptime Agent permitiéndote interactuar con tu sistema de monitoreo a través de asistentes de IA.

🛠️ Instalación

Requisitos previos

• Node.js 18 o superior
• Una cuenta activa de Uptime Agent
• Tu clave de API de Uptime Agent

Para obtener tu clave de API de Uptime Agent:

1. Inicia sesión en tu Panel de control de Uptime Agent
2. Navega a Cuenta → Claves de API
3. Crea una nueva clave de API con los permisos adecuados
4. Copia la clave generada para usarla con el servidor MCP

Opción 1: Instalación rápida mediante NPM (Recomendada)

La forma más rápida de comenzar es con nuestro comando de configuración:

npx uptime-agent-mcp setup

Este comando:

• Instalará el servidor MCP
• Lo configurará para usarlo con Claude Desktop
• Te pedirá tu clave de API de Uptime Agent
• Configurará automáticamente todas las configuraciones necesarias

Opción 2: Instalación mediante Smithery.ai

Para instalar usando Smithery.ai:

1. Crea una cuenta en smithery.ai
2. Obtén tu clave personal de tu cuenta de Smithery
3. Ejecuta el siguiente comando:

npx -y @smithery/cli@latest install @AVIMBU/uptime_agent_mcp --client claude --key <personal_key>

Reemplaza <personal_key> con tu clave personal real de Smithery.

Opción 3: Instalación manual local

Para usuarios avanzados que desean más control:

# Clone the repository
git clone https://github.com/AVIMBU/uptime_agent_mcp.git
cd uptime_agent_mcp

# Install dependencies
npm install

# Build the project
npm run build

Configura con tu clave de API creando un archivo .env:

UPTIME_API_KEY=your-api-key-here
PORT=3000  # Optional, defaults to 3000

Inicia el servidor:

npm start
# or directly with
node dist/index.js

🤖 Integración con Asistentes de IA

Configuración con Claude Desktop

Después de instalar usando uno de los métodos anteriores, tu servidor MCP se configura automáticamente para Claude Desktop.

Si instalaste manualmente, agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "uptime-agent": {
      "command": "npx",
      "args": [
        "-y",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Alternativamente, puedes usar Docker:

{
  "mcpServers": {
    "uptime-agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPTIME_API_KEY",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Ejemplos de Conversaciones

Verificando Monitores:

"Claude, muéstrame todos mis monitores de disponibilidad activos."

Creando un Nuevo Monitor:

"Por favor, crea un nuevo monitor para nuestro endpoint de API en https://api.mycompany.com/v2/health"

Analizando Incidentes:

"¿Qué incidentes ocurrieron en nuestros servidores de producción la semana pasada y cuál fue el tiempo de inactividad promedio?"

📊 Funciones Disponibles

Operaciones de Monitores

Función	Descripción	Parámetros
listMonitors	Obtén una lista completa de todos los endpoints de monitoreo	Ninguno requerido
getMonitor	Recupera información detallada sobre un monitor específico	id: Identificador del monitor
createMonitor	Configura un nuevo endpoint para monitorear	name: Nombre del monitor url: URL a monitorear tracking_type: Tipo de monitoreo (http, ping, etc.) check_frequency: Intervalo de verificación en segundos

Gestión de Incidentes

Función	Descripción	Parámetros
listIncidents	Ver todos los incidentes de caída detectados	Ninguno requerido
getIncident	Obtén información detallada sobre un incidente específico	id: Identificador del incidente
listIncidentsByMonitor	Ver todos los incidentes para un endpoint particular	monitor_id: Identificador del monitor

Seguimiento Público

Función	Descripción	Parámetros
createAnonymousTracking	Crear seguimiento público sin autenticación	url: URL a monitorear name: (Opcional) Nombre para el seguimiento

Integración con Slack (Próximamente)

Función	Descripción	Parámetros
slack_get_users	Listar todos los usuarios en el espacio de trabajo de Slack conectado	limit: Número máximo de usuarios cursor: Cursor de paginación
slack_post_message	Publicar notificaciones en Slack	channel_id: Canal al que publicar text: Contenido del mensaje

🐳 Despliegue con Docker

Proporcionamos soporte para Docker para un despliegue fácil:

# Build the Docker image
docker build -t uptime-agent-mcp .

# Run the container
docker run -p 3000:3000 -e UPTIME_API_KEY=your-api-key uptime-agent-mcp

📬 Soporte

Si tienes preguntas o necesitas ayuda:

• Abre un issue en GitHub
• Contáctanos a través de nuestro sitio web: AVIMBU

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para obtener más detalles.

---

Desarrollado con ❤️ por AVIMBU