🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

mcp-debug

Package Overview
Dependencies
Maintainers
1
Versions
7
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

mcp-debug

A debugging and development tool for MCP servers with hot-swapping, session recording, and automated playback testing

pipPyPI
Version
1.1.6
Weekly downloads
91
Maintainers
1

MCP Debug

A debugging and development tool for Model Context Protocol (MCP) servers.

Installation

# Run directly with uvx (recommended)
uvx mcp-debug --help

# Or install with pip
pip install mcp-debug
mcp-debug --help

Features

  • Hot-Swap Development - Replace server binaries without disconnecting MCP clients
  • Session Recording & Playback - Record JSON-RPC traffic for debugging and testing
  • Development Proxy - Multi-server aggregation with tool prefixing
  • Dynamic Server Management - Add/remove servers at runtime

Quick Start

# Start proxy with config
uvx mcp-debug --proxy --config config.yaml

# Record a session
uvx mcp-debug --proxy --config config.yaml --record session.jsonl

# Playback recorded requests
uvx mcp-debug --playback-client session.jsonl | ./your-mcp-server

Documentation

See the GitHub repository for full documentation.

License

MIT License

Keywords

debugging

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts