convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
elianfun

Graylog MCP Server

elianfun/graylog-mcp

Consulte logs Graylog via linguagem natural no Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server que integra Graylog ao Claude Desktop, permitindo consultas de logs em linguagem natural sem necessidade de acessar a interface web. Suporta buscas por eventos de interface, alertas de erro, Storm Control e logs de dispositivos com sintaxe Graylog/Lucene.

Instalação

$npx convez-ai elianfun/graylog-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Investigar eventos de queda de interfaces de rede
  • Analisar alertas de erro e avisos em tempo real
  • Monitorar eventos de Storm Control em switches
  • Buscar logs históricos de dispositivos específicos por IP ou hostname
  • Verificar status de saúde e métricas do cluster Graylog

Veredito

Ferramenta prática para times de infraestrutura e NOC que precisam consultar logs Graylog rapidamente via chat. Bem implementada com suporte a múltiplas queries comuns, embora exija configuração manual de credenciais e acesso à API Graylog.

README

A tradução para o português deste README ainda está na fila.

graylog-mcp

透過 Claude Desktop 以自然語言查詢 Graylog syslog 的 MCP Server 整合。

功能概述

  • 用自然語言對話就能查詢 Graylog log,不需要手動操作 Web UI
  • 支援介面斷線事件、錯誤告警、Storm Control、設備 log 等常用查詢
  • 支援 Graylog / Lucene 語法自訂搜尋

環境需求

項目說明
Python3.10 以上
Graylog7.x(需有 API Token)
Claude Desktop需安裝並支援 MCP

安裝

pip install mcp requests

設定

在專案目錄下建立 .env 檔案:

GRAYLOG_URL=http://<your-graylog-host>:9000
GRAYLOG_TOKEN=<your-api-token>

取得 Token:Graylog Web UI → 右上角帳號 → Edit Profile → API Tokens

Claude Desktop 設定

編輯 Claude Desktop 設定檔:

  • Windows:%APPDATA%\Claude\claude_desktop_config.json
  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "graylog": {
      "command": "python",
      "args": [
        "C:\\path\\to\\graylog-mcp\\server.py"
      ]
    }
  }
}

修改後需完全關閉 Claude Desktop 再重新啟動才會生效。

可用工具(MCP Tools)

工具名稱說明
test_connection測試 Graylog API 連線是否正常
get_system_status取得 Graylog 版本、主機名稱、啟動時間
get_cluster_status取得 Cluster 節點角色與健康狀態
get_streams列出所有 Stream 及啟用狀態
get_inputs列出所有 Input 來源與狀態
get_system_metricsJVM 記憶體使用量與訊息吞吐量
get_interface_events網路設備介面 Down/Up 事件(Cisco / Juniper)
get_errors_and_warningsError / Warning 等級訊息
get_device_logs查詢特定設備的 log(hostname 或 IP)
get_storm_control_eventsStorm Control 廣播風暴相關事件
search_logs以 Graylog / Lucene 語法自訂搜尋

對話範例

在 Claude Desktop 直接輸入:

Graylog 現在狀態正常嗎?
最近 1 小時有哪些介面斷線?
列出最近的 Error 和 Warning
192.168.56.16 這台設備最近有什麼 log?
有沒有 Storm Control 告警?
搜尋包含 OSPF 的 log(過去 6 小時)
列出所有 stream

檔案結構

graylog-mcp/
├── server.py      # MCP Server 主程式
├── .env           # API Token 設定(已加入 .gitignore,請勿上傳)
├── .gitignore
└── README.md

時間範圍參數對照

range_seconds 常用值:

說明秒數
15 分鐘900
1 小時3600
6 小時21600
24 小時86400
7 天604800

Syslog 嚴重等級對照

Level數值說明
EMERG0系統無法使用
ALERT1需立即處理
CRIT2嚴重狀況
ERROR3錯誤
WARN4警告
NOTICE5一般但重要
INFO6資訊
DEBUG7除錯

連線測試

python test_connection.py
Ver o original no GitHub

Bom para

Relacionados