MCP Server: Analyze & Debug MCP Logs

MCP Server: Analyze & Debug MCP Logs

site icon
2025.04.01 8
TypeScript日志分析调试工具开发效率
MCP-Analyzer 是一个专门用于分析和调试 Model Context Protocol (MCP) 日志的 MCP 服务器。它提供了对日志文件的直接访问,帮助用户轻松排查 MCP 集成问题,并理解 Claude 与用户工具的交互方式。
View on GitHub

Overview

基本能力

产品定位

MCP-Analyzer 是一个日志分析工具,专门用于处理和分析 MCP 日志,帮助开发者调试和优化 MCP 集成。

核心功能

  • 多平台支持:支持 macOS、Windows 和 Linux,自动识别平台特定的日志路径
  • 智能过滤:通过不区分大小写的文本搜索查找特定日志条目
  • 分页浏览:高效浏览大量日志集合
  • 大小管理:智能截断处理大日志文件
  • 无缝集成:直接与 Claude Desktop 集成

适用场景

  • 调试 MCP 集成问题
  • 分析 Claude 与工具的交互日志
  • 查找特定错误或事件日志

工具列表

  • 日志读取器:从标准位置读取日志文件
  • 日志过滤器:根据关键词过滤日志
  • 分页器:分页浏览大量日志

常见问题解答

  • 如何自定义日志路径?:使用 customPath 参数指定自定义日志目录
  • 如何限制读取的日志行数?:使用 lines 参数设置读取的行数
  • 如何过滤特定日志条目?:使用 filter 参数设置过滤关键词

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

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

# 安装依赖
npm i

# 编译 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

示例用法

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?

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。