MCP Server: 分析与调试MCP日志

<div align="center"> <img src="assets/mcp_logs.png" width="400"> <br> <br> <br> 🔍 <b>从所有平台的标准位置读取日志</b> <br> <br> 🔎 <b>过滤、分页和分析大量日志集合</b> <br> <br> </div>

🎯 概述

MCP日志阅读器是一个专门的MCP服务器，帮助您分析和调试模型上下文协议日志。它提供了Claude直接访问日志文件的能力，使您能够轻松地排查MCP集成问题并理解Claude如何与您的工具交互。

• 多平台支持：在macOS、Windows和Linux上运行，并具有特定于平台的日志路径
• 智能过滤：通过不区分大小写的文本搜索找到特定的日志条目
• 分页浏览：高效地导航大型日志集合
• 大小管理：处理大型日志文件时采用智能截断
• 无缝Claude集成：直接与Claude桌面版配合工作

🚀 快速开始

通过Smithery安装

要通过Smithery自动安装MCP日志阅读器到Claude桌面版：

npx -y @smithery/cli install @klara-research/MCP-Analyzer --client claude

手动安装

直接从GitHub安装：

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

# 安装依赖
npm i

编译和运行：

# 编译TypeScript
npx tsc

🔌 连接到Claude

将服务器添加到您的Claude桌面版配置中：

{
  "mcpServers": {
    "log-reader": {
      "command": "node",
      "args": [
        "/绝对路径/MCP-Analyzer/build"
      ]
    }
  }
}

然后重启Claude桌面版。

📋 可用参数

日志阅读器支持以下参数：

参数	描述	默认值
lines	从每个日志文件中读取的行数	1 100
filter	用于过滤日志条目的文本（不区分大小写）	""
customPath	自定义日志目录路径	操作系统特定
fileLimit	每页读取的最大文件数	5
page	分页设置中的页码	1

💡 示例用法

让Claude使用日志阅读器工具：

你能检查一下我最近一天的MCP日志中是否有连接错误吗？

或者使用特定参数：

你能查看MCP日志，使用filter="error"和lines=50来查找初始化问题吗？

⚙️ 工作原理

1. 服务器自动检测您的操作系统，并找到相应的日志目录
2. 它定位所有MCP日志文件，并按修改时间排序（最新优先）
3. 根据分页设置检索请求的日志文件页面
4. 文件处理时会考虑大小限制以防止响应过载
5. 返回经过过滤的内容，并带有分页详情

📄 许可证

MIT许可证