
pranavj17/mcp-server-graylog
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
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_idacross 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
- 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"
}
}
}
}
インストール
npx -y mcp-server-graylog設定
{
"mcpServers": {
"graylog": {
"command": "npx",
"args": ["-y", "mcp-server-graylog"],
"env": {
"BASE_URL": "https://graylog.example.com",
"API_TOKEN": "your_api_token_here"
}
}
}
}