MCP Log Reader

MIT License
5
  • Apple
  • Linux

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

🎯 概述

MCP 日志读取器是一款专用的 MCP 服务器,可帮助您分析和调试模型上下文协议 (MCP) 日志。它允许 Claude 直接访问日志文件,从而轻松排除 MCP 集成故障,并了解 Claude 如何与您的工具交互。

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

🚀 快速入门

直接从 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 许可证

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

专门的 MCP 服务器通过为 Claude 提供跨多个平台的日志文件的直接访问来帮助分析和调试模型上下文协议日志。

  1. 🎯 Overview
    1. 🚀 Quick Start
      1. 🔌 Connecting to Claude
        1. 📋 Available Parameters
          1. 💡 Example Usage
            1. ⚙️ How It Works
              1. 📄 License
                ID: kk3dqiuhqb