log-analyzer-mcp
log-analyzer-mcp
一个提供日志分析和系统指标工具的 MCP(模型上下文协议)服务器。通过 stdio 传输连接到 Claude Code,并公开 5 个用于搜索、计数和分析本地日志文件的工具。
功能
工具 | 描述 |
| 通过关键字或正则表达式搜索日志文件 |
| 按严重性级别(ERROR/WARN/INFO/DEBUG)统计日志条目 |
| 在特定时间范围内过滤日志 |
| 获取 CPU、内存和磁盘使用指标 |
| 格式化错误内容以进行 AI 辅助分析 |
快速开始
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run the server
npm start开发
# Run with hot reload
npm run dev与 Claude Code 集成
将服务器添加到 Claude Code:
# Project-level (only available in this directory)
claude mcp add log-analyzer -- node /path/to/log-analyzer-mcp/dist/index.js
# User-level (available globally)
claude mcp add log-analyzer --scope user -- node /path/to/log-analyzer-mcp/dist/index.js验证连接:
claude mcp list工具详情
search_logs
通过关键字或正则表达式搜索日志文件。支持搜索单个 .log 文件或整个目录。
{
"keywords": ["ERROR", "timeout"],
"regex": "connection.*failed",
"logPath": "/var/log",
"limit": 100
}count_by_level
按严重性级别统计日志条目,可选择按时间范围过滤。
{
"logPath": "/var/log",
"startTime": "2026-04-29T00:00:00Z",
"endTime": "2026-04-30T00:00:00Z"
}query_by_timerange
在特定时间范围内过滤日志,并可选择级别过滤器。
{
"startTime": "2026-04-29T00:00:00Z",
"endTime": "2026-04-30T00:00:00Z",
"logPath": "/var/log",
"level": "ERROR",
"limit": 100
}get_system_metrics
获取 CPU、内存和磁盘指标。支持 Windows 和 Linux。
{
"metrics": ["cpu", "memory", "disk"]
}explain_error
格式化错误内容以进行 AI 辅助的根本原因分析。
{
"errorContent": "java.lang.NullPointerException\n at com.example.Service.process(Service.java:42)",
"contextLines": 10
}架构
src/
├── index.ts # MCP Server entry point
├── tools/ # Individual MCP tool implementations
├── utils/
│ ├── log_parser.ts # Timestamp/level parsing, keyword/regex matching
│ └── metrics.ts # Cross-platform CPU/memory/disk metrics
└── types/ # TypeScript type definitions该服务器使用 @modelcontextprotocol/sdk 和 StdioServerTransport。工具通过 CallToolRequestSchema 处理程序进行注册。
关键设计决策
流处理:使用
readline + createReadStream处理大型日志文件,而无需将其全部加载到内存中跨平台:Windows (WMIC) 和 Linux (top/free/df) 双路径实现,具有运行时平台检测功能
容错解析:非标准日志格式会被保留而不是丢弃(缺失级别默认为 INFO,缺失时间戳默认为当前时间)
许可证
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yufeizhou666/my_mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server