pranavj17/mcp-server-graylog

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

6 stars 4 forks 품질 74 트렌드 18MIT

Repository Install

Simple, focused MCP server for Graylog log searching. Built for debugging production issues.

개요

Model Context Protocol (MCP) server for Graylog log searching. Search logs by absolute/relative timestamps, filter by streams, and debug production issues directly from Claude Desktop. - Search Graylog logs using exact timestamps, filter by application streams, and get actionable insights for troubleshooting production issues. - ✅ - Debug specific errors with exact time ranges - ✅ - Search recent logs (last N seconds) - ✅ - Follow a trace_id across all services - ✅ - See what happened ±N seconds around an error - ✅ - One tool call fans out to trace + context + baseline - ✅ - Group counts by service/level/pod/lead_id with bandwidth-efficient projection - ✅ - List all available streams/applications - ✅ - Verify Graylog connectivity - ✅ - ISO 8601 timestamps, query syntax, stream IDs - ✅ - Actionable errors for auth, network, and API issues - ✅ - 30-second timeouts prevent hanging - ✅ - 54 tests, 9.2/10 code quality score ~/Library/Application Support/Claude/claude_desktop_config.

README

원문 README의 일부입니다. 원문 보기.

mcp-server-graylog

Model Context Protocol (MCP) server for Graylog log searching. Search logs by absolute/relative timestamps, filter by streams, and debug production issues directly from Claude Desktop.

Built for production debugging - Search Graylog logs using exact timestamps, filter by application streams, and get actionable insights for troubleshooting production issues.

Features

✅ Absolute timestamp search - Debug specific errors with exact time ranges
✅ Relative timestamp search - Search recent logs (last N seconds)
✅ Distributed tracing - Follow a trace_id across all services
✅ Surrounding-log context - See what happened ±N seconds around an error
✅ Composite incident analysis - One tool call fans out to trace + context + baseline
✅ Field aggregation - Group counts by service/level/pod/lead_id with bandwidth-efficient projection
✅ Stream discovery - List all available streams/applications
✅ System health check - Verify Graylog connectivity
✅ Comprehensive validation - ISO 8601 timestamps, query syntax, stream IDs
✅ Clear error messages - Actionable errors for auth, network, and API issues
✅ Timeout handling - 30-second timeouts prevent hanging
✅ Production-ready - 54 tests, 9.2/10 code quality score

Installation
Configuration
Available Tools
Skills & agents
Query Examples
Troubleshooting
Development
Contributing
License

Installation

Option 1: Use with npx (Recommended)

# No installation needed - use directly with npx
npx mcp-server-graylog

Option 2: Global Installation

npm install -g mcp-server-graylog

Option 3: Local Installation

# Clone the repository
git clone https://github.com/Pranavj17/mcp-server-graylog.git
cd mcp-server-graylog

# Install dependencies
npm install

Configuration

Claude Desktop Setup

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (Recommended)

{
  "mcpServers": {
    "graylog": {
      "command": "npx",
      "args": ["-y", "mcp-server-graylog"],
      "env": {
        "BASE_URL": "https://graylog.example.com",
        "API_TOKEN": "your_api_token_here"
      }
    }
  }
}

GitHub에서 전체 README 보기

설치

npx -y mcp-server-graylog

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "graylog": {
      "command": "npx",
      "args": ["-y", "mcp-server-graylog"],
      "env": {
        "BASE_URL": "https://graylog.example.com",
        "API_TOKEN": "your_api_token_here"
      }
    }
  }
}