pranavj17/mcp-server-graylog

开发工具

本页由 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

新手？先看 mcpskill.org 教程 →

配置

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