MCP服务器：分析与调试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 Desktop配合使用

🚀 快速开始

直接从GitHub安装：

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

# 安装依赖项
npm i

构建并运行：

# 编译TypeScript
npx tsc

🔌 连接到Claude

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

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

然后重启Claude Desktop。

📋 可用参数

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

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

💡 使用示例

要求Claude使用日志读取器工具：

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

或使用特定参数：

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

⚙️ 工作原理

1. 服务器自动检测您的操作系统并找到相应的日志目录
2. 它找到所有MCP日志文件，并按修改时间排序（最新在前）
3. 根据分页设置检索请求的日志文件页面
4. 文件经过大小限制处理，以防止响应不堪重负
5. 过滤后的内容以结构化格式返回，并包含分页详细信息

📄 许可证

MIT许可证