内容
MCP 服务器：分析与调试 MCP 日志
[](https://smithery.ai/server/@klara-research/MCP-Analyzer)
<div align="center">
<img src="assets/mcp_logs.png" width="400">
<br>
<br>
<br>
🔍 <b>从所有平台的标准位置读取日志</b>
<br>
<br>
🔎 <b>过滤、分页和分析一大批日志</b>
<br>
<br>
</div>
## 🎯 概述
MCP 日志读取器是一款专门的 MCP 服务器，帮助您分析和调试模型上下文协议（Model Context Protocol）日志。它为 Claude 提供直接访问日志文件的权限，使其能够轻松地排除 MCP 集成问题并了解 Claude 如何与您的工具交互。
- **多平台支持**：在 macOS、Windows 和 Linux 上运行，支持特定于平台的日志路径
- **智能过滤**：使用不区分大小写的文本搜索查找特定的日志条目
- **分页浏览**：高效地浏览大量日志集合
- **大小管理**：通过智能截断处理大型日志文件
- **与 Claude 无缝集成**：直接与 Claude Desktop 配合使用
## 🚀 快速入门
### 通过 Smithery 安装
通过 [Smithery](https://smithery.ai/server/@klara-research/MCP-Analyzer) 自动为 Claude Desktop 安装 MCP 日志读取器：
```bash
npx -y @smithery/cli install @klara-research/MCP-Analyzer --client claude
```
### 手动安装
直接从 GitHub 安装：
```bash
# 克隆仓库
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer
# 安装依赖项
npm i
```
构建并运行：
```bash
# 编译 TypeScript
npx tsc
```
## 🔌 连接到 Claude
将服务器添加到您的 Claude Desktop 配置中：
```json
{
"mcpServers": {
"log-reader": {
"command": "node",
"args": [
"/绝对路径/MCP-Analyzer/build"
]
}
}
}
```
然后重启 Claude Desktop。
## 📋 可用参数
日志读取器支持以下参数：
| 参数 | 描述 | 默认值 |
|-----------|-------------|---------|
| `lines` | 从每个日志文件中读取的行数 | 100 |
| `filter` | 用于过滤日志条目的文本（不区分大小写） | "" |
| `customPath` | 日志目录的自定义路径 | 操作系统特定 |
| `fileLimit` | 每页要读取的最大文件数 | 5 |
| `page` | 分页的页码 | 1 |
## 💡 示例用法
要求 Claude 使用日志读取器工具：
```
您能否检查过去一天的 MCP 日志中是否有任何连接错误？
```
或使用特定参数：
```
您能否浏览 MCP 日志，筛选条件为“error”，并显示 50 行，以查找初始化问题？
```
## ⚙️ 工作原理
1. 服务器自动检测您的操作系统并找到合适的日志目录
2. 它定位所有 MCP 日志文件，并按修改时间排序（最新的在前）
3. 根据分页设置检索请求的日志文件页面
4. 处理文件时有限制大小，以防止响应过大
5. 过滤后的内容以结构化格式返回，包含分页详细信息
## 📄 许可证
MIT 许可证
MCP 市场