项目简介

MCP日志分析服务器（MCP Log Analyzer）是一个专门用于分析和调试Model Context Protocol (MCP) 日志的工具。它作为一个MCP服务器运行，允许LLM客户端（如Claude）通过MCP协议访问和查询系统中的MCP日志文件。这使得开发者能够更方便地了解LLM客户端与MCP服务器之间的交互，快速定位和解决集成过程中出现的问题。

主要功能点

跨平台日志读取: 支持 macOS、Windows 和 Linux 操作系统，自动识别并读取标准日志路径下的MCP日志文件。
灵活的日志过滤: 允许通过关键词对日志内容进行过滤，快速定位 интересующие 日志条目。
分页浏览: 支持分页加载和浏览大量日志文件，避免一次性加载过多数据导致性能问题。
智能大小管理: 能够处理大型日志文件，并通过截断等方式控制返回内容的大小，防止响应过大。
无缝 Claude 集成: 可以直接与 Claude Desktop 等 MCP 客户端配合使用，为开发者提供便捷的日志分析能力。

安装步骤

克隆仓库

git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

安装依赖
```
npm install
```
编译 TypeScript 代码
```
npx tsc
```

服务器配置

要将此 MCP 服务器添加到 MCP 客户端（例如 Claude Desktop），您需要配置服务器的启动命令。以下是配置示例，请根据您的实际情况修改路径：

{
  "mcpServers": {
    "log-reader": {  // 服务器名称，可以自定义
      "command": "node",  // 运行服务器的命令，这里使用 Node.js
      "args": [
        "/absolute/path/MCP-Analyzer/build/index.js"  //  MCP服务器入口文件 build/index.js 的**绝对路径**。请替换为您的实际路径
      ]
    }
  }
}

注意：

请将 '/absolute/path/MCP-Analyzer/build/index.js' 替换为 'MCP-Analyzer/build/index.js' 文件在您本地文件系统中的绝对路径。您需要先按照安装步骤完成代码编译，才会生成 'build' 目录。
'server name' ("log-reader") 可以自定义，在 Claude 中调用工具时会用到。
配置完成后，请重启您的 MCP 客户端（例如 Claude Desktop）以加载新的服务器配置。

基本使用方法

配置完成后，您可以在 Claude 等 MCP 客户端中使用 'read_mcp_logs' 工具来读取和分析 MCP 日志。

示例 1：查询最近一天的连接错误日志

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

示例 2：查询包含 "error" 关键词的日志，并限制每文件读取 50 行，用于查找初始化问题

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

可用参数：

您可以在调用 'read_mcp_logs' 工具时使用以下参数来控制日志读取行为：

'lines': 指定从每个日志文件末尾读取的行数 (默认为 100 行)。
'filter': 指定用于过滤日志条目的文本关键词（不区分大小写）。
'customPath': 自定义日志目录路径（默认为操作系统特定的标准日志路径）。
'fileLimit': 每页最多读取的文件数量 (默认为 5 个文件)。
'page': 分页页码 (默认为第 1 页)。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息