Prometheus

Prometheus MCP Server

Principais Recursos

• Rápido e leve. Integração direta com a API do Prometheus, sem necessidade de parsing complexo.
• Amigável para LLMs. Respostas JSON estruturadas e otimizadas para consumo por assistentes de IA.
• Capacidades configuráveis. Ative/desative categorias de ferramentas com base em seus requisitos de segurança e operacionais.
• Suporte a transporte duplo. Funciona com transportes stdio e HTTP para máxima compatibilidade.

Requisitos

• Node.js 20.19.0 ou mais recente
• Acesso a um servidor Prometheus
• VS Code, Cursor, Windsurf, Claude Desktop ou qualquer outro cliente MCP

Primeiros Passos

Primeiro, instale o servidor MCP do Prometheus com seu cliente. Uma configuração típica é assim:

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

# For VS Code
code --add-mcp '{"name":"prometheus","command":"npx","args":["prometheus-mcp@latest","stdio"],"env":{"PROMETHEUS_URL":"http://localhost:9090"}}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"prometheus","command":"npx","args":["prometheus-mcp@latest","stdio"],"env":{"PROMETHEUS_URL":"http://localhost:9090"}}'

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

Configuração

O servidor MCP do Prometheus suporta os seguintes argumentos. Eles podem ser fornecidos na configuração JSON acima, como parte da lista "args":

> npx prometheus-mcp@latest --help

Commands:
  stdio  Start Prometheus MCP server using stdio transport
  http   Start Prometheus MCP server using HTTP transport

Options:
  --help     Show help                          [boolean]
  --version  Show version number                [boolean]

Variáveis de Ambiente

Você também pode configurar o servidor usando variáveis de ambiente:

• PROMETHEUS_URL - URL do servidor Prometheus
• ENABLE_DISCOVERY_TOOLS - Defina como "false" para desativar as ferramentas de descoberta (padrão: true)
• ENABLE_INFO_TOOLS - Defina como "false" para desativar as ferramentas de informação (padrão: true)
• ENABLE_QUERY_TOOLS - Defina como "false" para desativar as ferramentas de consulta (padrão: true)

Servidor MCP Autônomo

Ao executar em ambientes de servidor ou quando precisar de transporte HTTP, execute o servidor MCP com o comando http:

npx prometheus-mcp@latest http --port 3000

E então, na configuração do seu cliente MCP, defina o url para o endpoint HTTP:

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

Docker

Execute o servidor MCP do Prometheus usando Docker:

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "--pull=always",
        "-e",
        "PROMETHEUS_URL=http://host.docker.internal:9090",
        "ghcr.io/idanfishman/prometheus-mcp",
        "stdio"
      ]
    }
  }
}

Ferramentas

O servidor MCP do Prometheus fornece 10 ferramentas organizadas em três categorias configuráveis:

Exemplos de Uso

Aqui estão alguns exemplos de interações que você pode ter com seu assistente de IA:

Consultas Básicas

• "Mostre-me todas as métricas disponíveis no Prometheus"
• "Qual é o uso atual de CPU em todas as instâncias?"
• "Obtenha o uso de memória da última hora"

Descoberta e Exploração

• "Liste todos os alvos de coleta e seus status"
• "Quais rótulos estão disponíveis para a métrica http_requests_total?"
• "Mostre-me todas as métricas relacionadas a 'cpu'"

Análise Avançada

• "Compare o uso de CPU entre os ambientes de produção e staging"
• "Mostre-me os 10 principais serviços por consumo de memória"
• "Qual é a tendência da taxa de erros do serviço de API nas últimas 24 horas?"

Considerações de Segurança

• Acesso à Rede: O servidor requer acesso de rede à sua instância do Prometheus
• Uso de Recursos: Consultas de intervalo podem consumir muitos recursos; monitore a carga do seu servidor Prometheus

Solução de Problemas

Problemas de Conexão

• Verifique se o seu servidor Prometheus está acessível na URL configurada
• Verifique as configurações de firewall e a conectividade de rede
• Certifique-se de que a API do Prometheus esteja habilitada (padrão na porta 9090)

Erros de Permissão

• Verifique se o servidor MCP tem acesso de rede ao Prometheus
• Verifique se a autenticação é necessária para sua configuração do Prometheus

Disponibilidade de Ferramentas

• Se algumas ferramentas estiverem ausentes, verifique se elas foram desativadas via configuração

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Suporte

• GitHub Issues: Relate bugs ou solicite recursos
• Documentação: Documentação do Model Context Protocol
• Prometheus: Documentação do Prometheus

Feito com ❤️ para as comunidades Prometheus e MCP