log-analyzer-mcp
AI-powered log analysis - parse, search, extract errors across 9+ formats
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"codesdevs-log-analyzer": {
"args": [
"codesdevs-log-analyzer@0.4.2"
],
"command": "uvx"
}
}
}可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
Log Analyzer MCP
<!- - mcp-name: io.github.Fato07/log-analyzer-mcp - ->
🔍 Stop copy-pasting logs into AI. Let Claude read them directly.
An MCP server for AI-powered log analysis. Parse, search, and debug log files across 9+ formats — right from Claude Code.
# 📊 At a Glance
| | |
|- --|- --|
| 14 MCP tools | 9+ log formats |
| 280 tests | 81%+ coverage |
# 🎬 Demo
Analyzing logs with 14 specialized tools
# 🤔 Why?
| Without log-analyzer-mcp | With log-analyzer-mcp |
|- -- -- -- -- -- -- -- -- -- -- -- -- -|- -- -- -- -- -- -- -- -- -- -- -|
| Copy-paste chunks of logs | Point Claude at the file |
| Lose context between pastes | Full file access |
| Manual format parsing | Auto-detection |
| Miss related errors | Smart correlation |
# ✨ Features
- Auto-Detection — Identifies format from 9+ common log types
- Smart Search — Pattern matching with context, regex, and time filtering
- Error Extraction — Groups similar errors, captures stack traces
- Natural Language — Ask questions like "what errors happened today?"
- Sensitive Data Scan — Detect PII, credentials, and secrets
- Multi-File Analysis — Correlate events across distributed systems
- Streaming — Handles 1GB+ files without memory issues
# 🚀 Quick Start
# Install (adds to Claude Code automatically)
uvx codesdevs-log-analyzer install
Then in Claude Code:
Analyze /var/log/app.log and tell me what's causing the errors
# 📦 Installation
# # One-liner (Recommended)
uvx codesdevs-log-analyzer install
# # Manual
# pip
pip install codesdevs-log-analyzer
# uv
uv tool install codesdevs-log-analyzer
Add to ~/.claude/settings.json:
{
"mcpServers": {
"log-analyzer": {
"command": "uvx",
"args": ["codesdevs-log-analyzer"]
}
}
}
# 📋 Supported Formats
| Format | Example |
|- -- -- -- -|- -- -- -- --|
| Syslog | Jan 15 10:30:00 hostname process[pid]: message |
| Apache/Nginx | 127.0.0.1 - - [15/Jan/2026:10:30:00] "GET /path" 200 |
| JSON Lines | {"timestamp": "...", "level": "ERROR", "message": "..."} |
| Docker | 2026-01-15T10:30:00.123Z stdout message |
| Python | 2026-01-15 10:30:00,123 - module - ERROR - message |
| Java/Log4j | 2026-01-15 10:30:00,123 ERROR [thread] class - message |
| Kubernetes | level=error msg="..." ts=2026-01-15T10:30:00Z |
| Generic | Any line with recognizable timestamp |
# ⚡ Performance
| Metric | Value |
|- -- -- -- -|- -- -- --|
| 100MB log file | < 10 seconds |
| Memory footprint | Streaming (no full load) |
| Max tested size | 1GB+ |
| Format detection | < 100ms |
# 🛠️ Available Tools
| Tool | Description |
|- -- -- -|- -- -- -- -- -- --|
| log_analyzer_parse | Detect format and extract metadata |
| log_analyzer_search | Search with context lines |
| log_analyzer_extract_errors | Extract and group errors |
| log_analyzer_summarize | Generate debugging summary |
| log_analyzer_correlate | Find related events |
| log_analyzer_watch | Monitor for new entries |
| log_analyzer_ask | Natural language queries |
| log_analyzer_scan_sensitive | Detect PII/credentials |
| + 6 more | Full reference → |
# 💡 Examples
Find errors:
Extract all errors from /var/log/app.log, group similar ones
Search with context:
Search for "timeout" in app.log with 5 lines of context
Correlate events:
What happened 60 seconds before each OutOfMemoryError?
Scan for secrets:
Check /var/log/app.log for accidentally logged credentials
# 🔧 Development
git clone https://github.com/Fato07/log-analyzer-mcp
cd log-analyzer-mcp
uv sync
uv run pytest -v - -cov
# 📈 Star History
[](https://star-history.com/# Fato07/log-analyzer-mcp&Date)
# 📄 License
MIT License - see LICENSE for details.
