Mezmo

Mezmo MCP Server

Um servidor Model Context Protocol (MCP) para recuperar logs do Mezmo. Design consciente de cota com padrões inteligentes - basta adicionar sua chave de API e executar!

⚡ Padrões Inteligentes

• Intervalo de Tempo: Últimas 6 horas (quando não especificado) - equilibra cota com a busca de logs reais
• Quantidade de Logs: 10 logs por solicitação
• Níveis de Log: Todos os níveis (você controla a filtragem)

Fluxo de Trabalho Recomendado:

1. Primeiro, busque 3-5 logs para descobrir aplicativos disponíveis e a forma dos logs
2. Depois, filtre por aplicativo(s) específico(s) que você está depurando
3. Adicione filtragem por nível para ERROR/WARNING para reduzir ruído
4. Aumente a quantidade somente após os filtros estarem em vigor (ex.: 20-50)
5. Essa abordagem minimiza significativamente o uso de cota!

🚀 Início Rápido

1. Obtenha Sua Chave de API

Obtenha sua chave de API de serviço Mezmo no painel do Mezmo.

2. Execute com 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. Configure Seu Cliente MCP

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

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

Para Claude Desktop (adicione às configurações do MCP):

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

4. Comece a Usar

Reinicie seu cliente MCP e você terá acesso à ferramenta get_logs!

📋 Uso

A ferramenta get_logs recupera automaticamente logs das últimas 6 horas quando nenhum intervalo de tempo é especificado - perfeita para depuração enquanto economiza cota.

Passo 1: Descubra aplicativos disponíveis (3-5 logs):

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

Passo 2: Filtre por aplicativo específico:

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

Filtragem avançada (aumente a escala somente após os filtros funcionarem):

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

Intervalo de tempo personalizado (use com moderação - impacta a cota):

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

💡 Dicas Conscientes de Cota

1. Sempre filtre por aplicativo quando possível - isso reduz drasticamente os resultados
2. Comece pequeno - use count=3-5 para descoberta, depois aumente se necessário
3. Adicione filtragem por nível - especifique levels="ERROR,WARNING" para reduzir ruído
4. Use a janela padrão de 6 horas a menos que precise de dados históricos mais amplos

🔐 Segurança / Segredos

• Nunca faça commit de .env (ele contém seu MEZMO_API_KEY).
• Prefira usar .env.example como modelo e mantenha seus valores reais localmente.
• Se você habilitar a autenticação MCP (MCP_ENABLE_AUTH=true), mantenha MCP_API_TOKEN em segredo também.

🛠️ Comandos

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

🐛 Solução de Problemas

O contêiner não inicia?

• Verifique se o arquivo .env tem MEZMO_API_KEY=your_actual_key
• Veja os logs: docker-compose logs

Não consegue conectar do cliente MCP?

• Garanta que o contêiner esteja em execução: docker-compose ps
• Reinicie seu cliente MCP após alterações de configuração

É isso! O servidor roda na porta 18080 e lida automaticamente com janelas de tempo, tentativas e tratamento de erros.