log

Name: log
Author: rog0x

本地服务

github.com/rog0x数据与分析132 周前更新

代码仓库

关于 log

@rog0x/mcp-log-tools 是面向 AI Agent 的日志处理与分析 MCP 服务，支持常见日志格式和自定义正则解析。它提供过滤、统计、异常检测及格式转换功能。

主要功能

01解析常见及自定义日志
02按级别、日期和关键词过滤
03统计错误与请求趋势
04检测日志量异常变化
05转换格式并生成报告

适用场景

01筛选指定时间段的错误日志
02分析 HTTP 访问量和慢端点
03将日志转换为 CSV 或表格

MCP 相关

通过 MCP 向 AI Agent 暴露日志解析、筛选、分析、格式化和统计工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rog0x-log": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-log-tools"
      ]
    }
  }
}

启动命令npx -y @rog0x/mcp-log-tools

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@rog0x/mcp-log-tools1.0.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	number	否	返回条目的最大数量
format	enum	否	用于解析的日志格式。使用 'auto' 可自动检测。auto \| json \| apache \| nginx \| syslog \| custom
content	string	是	要解析的原始日志内容
custom_pattern	string	否	带命名组的自定义 regex 模式：(?<timestamp>)、(?<level>)、(?<message>)、(?<source>)

详细介绍

@rog0x/mcp-log-tools

通过模型上下文协议（MCP）向 AI Agent 提供的日志分析和处理工具。

工具

parse_logs

解析常见格式的日志内容：JSON 日志、Apache/Nginx 访问日志、syslog 和结构化日志。支持使用命名捕获组的自定义正则表达式模式。提取时间戳、级别、消息、来源和其他结构化字段。

filter_logs

根据以下条件筛选已解析的日志条目：

日志级别（ERROR、WARN、INFO、DEBUG）
日期范围（ISO 8601）
关键词搜索（不区分大小写）
正则表达式模式匹配
来源/日志记录器名称

返回匹配的条目以及各级别的出现次数。

analyze_logs

分析日志模式，揭示运营洞察：

出现频率最高的 10 个错误（已归一化）
随时间变化的错误率（按小时分桶）
每小时请求量
响应最慢的端点（来自 HTTP 访问日志）
异常检测（使用标准差检测突然的峰值或下降）

format_logs

转换日志格式并生成报告：

将 JSON 转换为纯文本，或将纯文本转换为 JSON、CSV 或表格
按日志级别添加 ANSI 颜色
提取结构化字段
生成摘要报告

log_stats

计算全面的日志统计信息：

总行数和非空行数
各级别分布及百分比
日期范围覆盖情况
唯一 IP 地址和请求数
常见 User-Agent
HTTP 状态码分布
吞吐量（每秒条目数）

设置

npm install
npm run build

在 Claude Desktop 中使用

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "log-tools": {
      "command": "node",
      "args": ["path/to/mcp-log-tools/dist/index.js"]
    }
  }
}

支持的日志格式

格式	示例
JSON	`{"timestamp":"2024-01-15T10:30:00Z","level":"ERROR","message":"Connection failed"}`
Apache/Nginx	`127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /index.html HTTP/1.1" 200 2326`
Syslog	`Jan 1 00:00:00 hostname process[1234]: Something happened`
结构化	`2024-01-15T10:30:00.000Z [ERROR] [ModuleName] Something failed`
自定义	使用带命名捕获组的正则表达式匹配的任意格式

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

log