🚀 MCP 服务器：分析与调试 MCP 日志
MCP 日志阅读器是专业的 MCP 服务器，可助力分析和调试模型上下文协议日志。它能让 Claude 直接访问日志文件，便于排查 MCP 集成问题，理解 Claude 与工具的交互情况。
🚀 快速开始
直接从 GitHub 安装：
# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer
# 安装依赖项
npm i
构建并运行：
# 编译 TypeScript
npx tsc
✨ 主要特性
- 🔍 多平台支持：适用于 macOS、Windows 和 Linux，并带有特定于平台的日志路径。
- 🔎 智能过滤：通过不区分大小写的文本搜索查找特定日志条目。
- 📖 分页浏览：高效地导航大型日志集合。
- 💾 容量管理：处理大文件时具有智能截断功能。
- 🤝 与 Claude 无缝集成：直接与 Claude 桌面配合使用。
📦 安装指南
直接从 GitHub 安装：
# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer
# 安装依赖项
npm i
构建并运行：
# 编译 TypeScript
npx tsc
💻 使用示例
基础用法
让 Claude 使用日志阅读工具：
你能检查我在过去一天内的 MCP 日志中是否有任何连接错误吗？
高级用法
使用特定参数：
你能过滤“error”并设置 lines=50 来查找初始化问题吗？
📚 详细文档
🔌 与 Claude 连接
将服务器添加到您的 Claude 桌面配置中：
{
"mcpServers": {
"log-reader": {
"command": "node",
"args": [
"/absolute/path/MCP-Analyzer/build"
]
}
}
}
然后重新启动 Claude 桌面。
📋 可用参数
日志阅读器支持以下参数：
| 参数 | 描述 | 默认值 |
|---|---|---|
lines |
每个日志文件读取的行数 | 100 |
filter |
过滤日志条目的文本（不区分大小写） | "" |
customPath |
日志目录的自定义路径 | 操作系统特定值 |
fileLimit |
每页读取的最大文件数 | 5 |
page |
分页器的当前页码 | 1 |
⚙️ 工作原理
- 服务器自动检测您的操作系统，并找到合适的日志目录。
- 它定位所有 MCP 日志文件并按修改时间排序（最新的优先）。
- 根据分页设置获取请求的页面。
- 文件以大小限制进行处理，以防止响应过载。
- 过滤后的内容以结构化的格式返回，并附有分页详细信息。
📄 许可证
MIT License