MCP日志分析工具

MCP日志分析工具是一款专门用于分析和调试Model Context Protocol日志的服务器,支持多平台日志读取、智能过滤和分页浏览,帮助用户快速定位和解决MCP集成问题。

  • by klara-research
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 klara-research/MCP-Analyzer

使用说明

MCP服务器:分析和调试MCP日志




🔍 Read logs from standard locations across all platforms

🔎 Filter, paginate, and analyze large log collections

🎯 概述

MCP日志读取器是一个专门的MCP服务器,可帮助您分析和调试模型上下文协议日志。它为Claude提供了对日志文件的直接访问,使其易于对MCP集成进行故障排除,并了解Claude如何与您的工具交互。

  • 多平台支持:适用于macOS、Windows和Linux,具有特定于平台的日志路径
  • 智能过滤:使用不区分大小写的文本搜索查找特定日志条目
  • 分页浏览:高效地浏览大型日志集合
  • 尺寸管理:使用智能截断处理大型日志文件
  • 无缝集成Claude:直接与Claude Desktop配合使用

🚀 快速开始

通过Smithery安装

通过以下方式自动安装Claude Desktop的MCP日志读取器 史密瑟里:

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 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许可证