Mezmo

Servidor MCP de Mezmo

Un servidor de Protocolo de Contexto de Modelo (MCP) para recuperar registros de Mezmo. Diseño consciente de cuota con valores predeterminados inteligentes: ¡solo agrega tu clave de API y ejecuta!

⚡ Valores Predeterminados Inteligentes

• Rango de tiempo: Últimas 6 horas (cuando no se especifica) - equilibra la cuota con la búsqueda de registros reales
• Cantidad de registros: 10 registros por solicitud
• Niveles de registro: Todos los niveles (tú controlas el filtrado)

Flujo de trabajo recomendado:

1. Primero, obtén de 3 a 5 registros para descubrir las aplicaciones disponibles y la forma de los registros
2. Luego, filtra por la(s) aplicación(es) específica(s) que estás depurando
3. Agrega filtrado por nivel para ERROR/ADVERTENCIA para reducir el ruido
4. Aumenta la cantidad solo después de tener los filtros en su lugar (por ejemplo, 20-50)
5. ¡Este enfoque minimiza significativamente el uso de la cuota!

🚀 Inicio Rápido

1. Obtén tu Clave de API

Obtén tu clave de API de servicio de Mezmo desde el panel de control de Mezmo.

2. Ejecuta con Docker

# Clone the repository
# (replace with your fork/clone URL)
git clone <your-repo-url>
cd <your-repo-dir>

# Create your local .env (never commit it)
cp env.example .env
# then edit .env and set MEZMO_API_KEY

# Build and run
docker-compose up -d

3. Configura tu Cliente MCP

Para Cursor (agrega a .cursor/mcp.json):

{
  "mcpServers": {
    "mezmo": {
      "url": "http://localhost:18080/mcp",
      "transport": "streamable-http",
      "description": "Mezmo log retrieval"
    }
  }
}

Para Claude Desktop (agrega a la configuración de MCP):

{
  "mcpServers": {
    "mezmo": {
      "command": "docker",
      "args": ["exec", "mezmo-mcp-server", "python", "server.py"]
    }
  }
}

4. Comienza a Usar

Reinicia tu cliente MCP y tendrás acceso a la herramienta get_logs!

📋 Uso

La herramienta get_logs recupera automáticamente registros de las últimas 6 horas cuando no se especifica un rango de tiempo: perfecta para depurar mientras se conserva la cuota.

Paso 1: Descubre las aplicaciones disponibles (3-5 registros):

{
  "count": 3,
  "levels": "ERROR,WARNING"
}

Paso 2: Filtra por aplicación específica:

{
  "count": 10,
  "apps": "app-a",
  "levels": "ERROR,WARNING"
}

Filtrado avanzado (aumenta solo después de que los filtros funcionen):

{
  "count": 50,
  "apps": "app-a,app-b",
  "levels": "ERROR,WARNING",
  "query": "database connection"
}

Rango de tiempo personalizado (úsalo con moderación: afecta la cuota):

{
  "count": 50,
  "apps": "app-a",
  "from_ts": "1640995200",
  "to_ts": "1640998800"
}

💡 Consejos para Ahorrar Cuota

1. Siempre filtra por aplicación cuando sea posible: esto reduce drásticamente los resultados
2. Comienza pequeño - usa count=3-5 para descubrir, luego aumenta si es necesario
3. Agrega filtrado por nivel - especifica levels="ERROR,WARNING" para reducir el ruido
4. Usa la ventana predeterminada de 6 horas a menos que necesites datos históricos más amplios

🔐 Seguridad / Secretos

• Nunca hagas commit de .env (contiene tu MEZMO_API_KEY).
• Prefiere usar .env.example como plantilla y mantén tus valores reales en local.
• Si habilitas la autenticación MCP (MCP_ENABLE_AUTH=true), mantén también en secreto MCP_API_TOKEN.

🛠️ Comandos

docker-compose up -d     # Start the server
docker-compose down      # Stop the server
docker-compose logs -f   # View logs

🐛 Solución de Problemas

¿El contenedor no arranca?

• Verifica que tu archivo .env tenga MEZMO_API_KEY=your_actual_key
• Ver registros: docker-compose logs

¿No puedes conectarte desde el cliente MCP?

• Asegúrate de que el contenedor esté en ejecución: docker-compose ps
• Reinicia tu cliente MCP después de los cambios de configuración

¡Eso es todo! El servidor se ejecuta en el puerto 18080 y maneja automáticamente ventanas de tiempo, reintentos y manejo de errores.