# MCP Analyzer

> An MCP server to read MCP logs to debug directly inside the client

- **Type:** MCP server
- **Install:** `agentstack add mcp-klara-research-mcp-analyzer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [klara-research](https://agentstack.voostack.com/s/klara-research)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [klara-research](https://github.com/klara-research)
- **Source:** https://github.com/klara-research/MCP-Analyzer

## Install

```sh
agentstack add mcp-klara-research-mcp-analyzer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Server: Analyze & Debug MCP Logs

[](https://smithery.ai/server/@klara-research/MCP-Analyzer)

  
  
  
  
  
  🔍 Read logs from standard locations across all platforms
  
  
  🔎 Filter, paginate, and analyze large log collections
  
  

## 🎯 Overview

MCP Log Reader is a specialized MCP server that helps you analyze and debug Model Context Protocol logs. It provides Claude with direct access to log files, making it easy to troubleshoot MCP integrations and understand how Claude interacts with your tools.

- **Multi-platform Support**: Works on macOS, Windows, and Linux with platform-specific log paths
- **Smart Filtering**: Find specific log entries with case-insensitive text search
- **Paginated Browsing**: Navigate large log collections efficiently
- **Size Management**: Handles large log files with intelligent truncation
- **Seamless Claude Integration**: Works directly with Claude Desktop

## 🚀 Quick Start

### Installing via Smithery

To install MCP Log Reader for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@klara-research/MCP-Analyzer):

```bash
npx -y @smithery/cli install @klara-research/MCP-Analyzer --client claude
```

### Installing Manually

Install directly from GitHub:
```bash
# Clone the repository
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

# Install dependencies
npm i
```

Build and run:
```bash
# Compile TypeScript
npx tsc
```

## 🔌 Connecting to Claude

Add the server to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "log-reader": {
      "command": "node",
      "args": [
        "/absolute/path/MCP-Analyzer/build"
      ]
    }
  }
}
```

Then restart Claude Desktop.

## 📋 Available Parameters

The log reader supports these parameters:

| Parameter | Description | Default |
|-----------|-------------|---------|
| `lines` | Number of lines to read from each log file | 100 |
| `filter` | Text to filter log entries by (case-insensitive) | "" |
| `customPath` | Custom path to log directory | OS-specific |
| `fileLimit` | Maximum number of files to read per page | 5 |
| `page` | Page number for pagination | 1 |

## 💡 Example Usage

Ask Claude to use the log reader tool:

```
Can you check my MCP logs for any connection errors in the last day?
```

Or with specific parameters:

```
Can you look through MCP logs with filter="error" and lines=50 to find initialization issues?
```

## ⚙️ How It Works

1. The server automatically detects your OS and finds the appropriate log directory
2. It locates all MCP log files and sorts them by modification time (newest first)
3. The requested page of log files is retrieved based on pagination settings
4. Files are processed with size limits to prevent overwhelming responses
5. Filtered content is returned in a structured format with pagination details

## 📄 License

MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [klara-research](https://github.com/klara-research)
- **Source:** [klara-research/MCP-Analyzer](https://github.com/klara-research/MCP-Analyzer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-klara-research-mcp-analyzer
- Seller: https://agentstack.voostack.com/s/klara-research
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.