🛡️ Mcpspect

Mcpspect is a transparent proxy and real-time observability dashboard for Model Context Protocol (MCP). It allows you to inspect, log, and audit every tool call and response between your LLM and your MCP servers with zero latency.

✨ Features

• 🕵️ Transparent Proxying: Intercept STDIO traffic without modifying a single byte.
• 📊 Real-time Dashboard: A modern Next.js timeline view of all tool interactions.
• 💾 Persistent History: All sessions and calls are stored in a local SQLite database (~/.mcpwatch/mcpwatch.db).
• ⚡ Zero-Latency: Built with Bun for ultra-efficient stream processing.
• 🛠️ Developer Friendly: Drop-in replacement for any MCP server command.

🚀 Quick Start

1. Installation

# Install globally via NPM
npm install -g mcpspect

# OR run instantly
npx mcpspect dev

2. Monitor an MCP Server

Use mcpspect start --target "<command>":

# Example: Proxy the "everything" MCP server
mcpspect start --target "npx -y @modelcontextprotocol/server-everything"

3. Open Dashboard

Open your browser at: http://localhost:3000

🖥️ Claude Desktop Integration

Update your claude_desktop_config.json:

{
  "mcpServers": {
    "monitored-server": {
      "command": "mcpspect",
      "args": [
        "start",
        "--target",
        "npx -y @modelcontextprotocol/server-everything"
      ]
    }
  }
}

🏗️ Architecture

[ LLM Client ] <---> [ Mcpspect Proxy ] <---> [ Target MCP Server ]
                            |
                            v
                     [ SQLite DB ] <--- [ Dashboard API ]

📜 License

MIT © [404-UNKNOW]