JinDaGe - Log Analyzer MCP Details

article

README

🚀 MCP 服务器：分析与调试 MCP 日志

MCP 日志阅读器是一个专用的 MCP 服务器，可帮助您分析和调试 Model Context Protocol 日志。它能让 Claude 直接访问日志文件，便于排查 MCP 集成问题，理解 Claude 与您工具的交互方式。

🚀 快速开始

直接从 GitHub 安装：

# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

# 安装依赖项
npm i

构建并运行：

# 编译 TypeScript
npx tsc

✨ 主要特性

多平台支持：适用于 macOS、Windows 和 Linux，并带有特定于平台的日志路径。
智能过滤：通过不区分大小写的文本搜索查找特定日志条目。
分页浏览：高效地导航大量日志集合。
容量管理：处理大文件时具有智能截断功能。
与 Claude 平滑集成：直接与 Claude Desktop 一起使用。

📦 安装指南

直接从 GitHub 安装：

# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

# 安装依赖项
npm i

构建并运行：

# 编译 TypeScript
npx tsc

💻 使用示例

基础用法

让 Claude 使用日志阅读工具：

你能检查我在过去一天中的 MCP 日志中是否有连接错误吗？

高级用法

结合具体参数：

你能使用 filter="error" 和 lines=50 查找初始化问题吗？

📚 详细文档

🔌 连接到 Claude

将服务器添加到您的 Claude Desktop 配置中：

{
  "mcpServers": {
    "log-reader": {
      "command": "node",
      "args": [
        "/absolute/path/MCP-Analyzer/build"
      ]
    }
  }
}

然后重启 Claude Desktop。

📋 可用参数

日志阅读器支持以下参数： | 参数 | 描述 | 默认值 | |------|------|--------| | lines | 每个日志文件要读取的行数 | 100 | | filter | 过滤日志条目的文本（不区分大小写） | "" | | customPath | 日志目录的自定义路径 | 操作系统特定值 | | fileLimit | 每页读取的最大文件数 | 5 | | page | 分页器的当前页码 | 1 |

🔧 技术细节

服务器自动检测您的操作系统并找到适当的日志目录。
它定位所有 MCP 日志文件并将它们按修改时间排序（最新文件优先）。
根据分页设置检索请求的页面。
文件按大小限制处理以防止过大响应。
过滤后的内容以结构化的格式返回，带有分页详细信息。

📄 许可证

MIT License

Log Analyzer