
MCP Server: Analyze & Debug MCP Logs

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?