PM

pranavj17/mcp-server-graylog

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

6 stars 4 forks 品質 81 トレンド 34MIT

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

Table of Contents

Installation

# 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

{
  "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" } } } }