🚀 MCP 服务器：分析与调试 MCP 日志
MCP 日志阅读器是一个专用的 MCP 服务器，可帮助您分析和调试 Model Context Protocol 日志。它能让 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 Desktop 一起使用。
📦 安装指南
直接从 GitHub 安装：
# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer
# 安装依赖项
npm i
构建并运行：
# 编译 TypeScript
npx tsc
💻 使用示例
基础用法
让 Claude 使用日志阅读工具：
你能检查我在过去一天中的 MCP 日志中是否有连接错误吗？
高级用法
结合具体参数：
你能使用 filter="error" 和 lines=50 查找初始化问题吗？
📚 详细文档
🔌 连接到 Claude
将服务器添加到您的 Claude Desktop 配置中：
{
"mcpServers": {
"log-reader": {
"command": "node",
"args": [
"/absolute/path/MCP-Analyzer/build"
]
}
}
}
然后重启 Claude Desktop。
📋 可用参数
日志阅读器支持以下参数：
| 参数 | 描述 | 默认值 |
|---|---|---|
lines |
每个日志文件要读取的行数 | 100 |
filter |
过滤日志条目的文本（不区分大小写） | "" |
customPath |
日志目录的自定义路径 | 操作系统特定值 |
fileLimit |
每页读取的最大文件数 | 5 |
page |
分页器的当前页码 | 1 |
🔧 技术细节
- 服务器自动检测您的操作系统并找到适当的日志目录。
- 它定位所有 MCP 日志文件并将它们按修改时间排序（最新文件优先）。
- 根据分页设置检索请求的页面。
- 文件按大小限制处理以防止过大响应。
- 过滤后的内容以结构化的格式返回，带有分页详细信息。
📄 许可证
MIT License