Graylog MCP Server
elianfun/graylog-mcp
Consulte logs Graylog via linguagem natural no Claude
Ver no GitHubMCP 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-mcp1 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
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 語法自訂搜尋
環境需求
| 項目 | 說明 |
|---|---|
| Python | 3.10 以上 |
| Graylog | 7.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_metrics | JVM 記憶體使用量與訊息吞吐量 |
get_interface_events | 網路設備介面 Down/Up 事件(Cisco / Juniper) |
get_errors_and_warnings | Error / Warning 等級訊息 |
get_device_logs | 查詢特定設備的 log(hostname 或 IP) |
get_storm_control_events | Storm 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 | 數值 | 說明 |
|---|---|---|
| EMERG | 0 | 系統無法使用 |
| ALERT | 1 | 需立即處理 |
| CRIT | 2 | 嚴重狀況 |
| ERROR | 3 | 錯誤 |
| WARN | 4 | 警告 |
| NOTICE | 5 | 一般但重要 |
| INFO | 6 | 資訊 |
| DEBUG | 7 | 除錯 |
連線測試
python test_connection.py