MCP Server: Analyze & Debug MCP Logs

MCP 服务：分析和调试 MCP 日志

🎯 概述

MCP Log Reader 是一款专用的 MCP 服务，可帮助你分析和调试 Model Context Protocol 日志。它让 Claude 能够直接访问日志文件，方便你排查 MCP 集成问题，并了解 Claude 如何与你的工具交互。

• 多平台支持：适用于 macOS、Windows 和 Linux，并使用各平台对应的日志路径
• 智能筛选：通过不区分大小写的文本搜索查找特定日志条目
• 分页浏览：高效浏览大型日志集合
• 大小管理：通过智能截断处理大型日志文件
• 与 Claude 无缝集成：可直接与 Claude Desktop 配合使用

🚀 快速开始

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 MCP Log Reader：

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

手动安装

直接从 GitHub 安装：

# Clone the repository
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

# Install dependencies
npm i

构建并运行：

# Compile 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 使用日志读取器工具：

Can you check my MCP logs for any connection errors in the last day?

或指定参数：

Can you look through MCP logs with filter="error" and lines=50 to find initialization issues?

⚙️ 工作原理

1. 服务自动检测你的操作系统并查找对应的日志目录
2. 服务定位所有 MCP 日志文件，并按修改时间排序（最新的在前）
3. 根据分页设置检索指定页的日志文件
4. 通过大小限制处理文件，以免响应内容过多
5. 以结构化格式返回筛选后的内容及分页详情

📄 许可证

MIT 许可证