Mezmo MCP Server

Un servidor Model Context Protocol (MCP) per recuperar registres de Mezmo. Funciona directament amb finestres de temps automàtiques de 4 hores - només afegeix la teva clau API i executa!

🚀 Inici ràpid

1. Obteniu la vostra clau API

Obteniu la vostra clau API del servei Mezmo des del tauler de control de Mezmo.

2. Executeu amb Docker

# Clone the repository
git clone https://github.com/riefer02/mezmo-logs-mcp
cd mezmo-mcp

# Create .env file with your API key
echo "MEZMO_API_KEY=your_service_key_here" > .env

# Build and run
docker-compose up -d

3. Configureu el vostre client MCP

Per a Cursor (afegeix a .cursor/mcp.json):

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

Per a Claude Desktop (afegeix a la configuració MCP):

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

4. Comença a usar

Reinicia el teu client MCP i tindràs accés a l'eina get_logs!

📋 Ús

L'eina get_logs recupera automàticament els registres de les últimes 4 hores quan no s'especifica rang de temps - perfecte per a depuració.

Ús simple:

{
  "count": 50
}

Amb filtres:

{
  "count": 100,
  "apps": "web-app,api-service",
  "levels": "ERROR,WARNING",
  "query": "database connection"
}

Rang de temps personalitzat:

{
  "count": 100,
  "from_ts": "1640995200",
  "to_ts": "1640998800"
}

🛠️ Comandes

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

🐛 Resolució de problemes

El contenidor no s'inicia?

• Check your .env file has MEZMO_API_KEY=your_actual_key
• View logs: docker-compose logs

No pots connectar des del client MCP?

• Ensure container is running: docker-compose ps
• Restart your MCP client after configuration changes

¡Això és tot! El servidor s'executa al port 18080 i gestiona automàticament finestres de temps, reintents i gestió d'errors.