v1.1.6

MCP Debug v1.1.6

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx @standardbeagle/mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.6/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.6

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.5...v1.1.6

v1.1.5

MCP Debug v1.1.5

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.5/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.5

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.4...v1.1.5

v1.1.4

MCP Debug v1.1.4

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.4/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.4

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.3...v1.1.4

v1.1.3

MCP Debug v1.1.3

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.3/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.3

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.2...v1.1.3

v1.1.2

MCP Debug v1.1.2

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.2/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.2

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.0...v1.1.2

v1.1.1

MCP Debug v1.1.1

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.1/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.1

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.1.0...v1.1.1

v1.1.0

MCP Debug v1.1.0

A debugging and development tool for MCP servers.

Installation

# Using uvx (Python)
uvx mcp-debug --help

# Using npx (Node.js)
npx mcp-debug --help

# Direct binary download (Linux amd64)
curl -L https://github.com/standardbeagle/mcp-debug/releases/download/v1.1.0/mcp-debug-linux-amd64 -o mcp-debug
chmod +x mcp-debug

# Or build from source
go install github.com/standardbeagle/mcp-debug@v1.1.0

Features

• Hot-swap server binaries without disconnecting clients
• Session recording and playback for testing
• Multi-server proxy with tool prefixing
• Dynamic server management

See the README for full documentation.

Full Changelog: v1.0.0...v1.1.0

MCP Debug v1.0.0 - Initial Release

🎉 The Essential Debugging Tool for MCP Servers

✨ Features

🔄 Hot-Swap Development

• Replace MCP server binaries without disconnecting clients
• Add/remove servers dynamically during development
• Tool name preservation - same interface, new implementation
• Graceful disconnect/reconnect workflow

📹 Session Recording & Playback

• Record JSON-RPC traffic for debugging and documentation
• Playback client mode - replay requests to test servers
• Playback server mode - replay responses to test clients
• Regression testing with recorded sessions

🛠️ Development Proxy

• Multi-server aggregation with tool prefixing
• Real-time connection monitoring with failure detection
• Management API for server lifecycle control
• Comprehensive logging with configurable output

🚀 Quick Start

# Install
go install github.com/standardbeagle/mcp-debug@latest

# Or download binary from releases
# Start debugging proxy
mcp-debug --proxy --config empty-config.yaml

# Connect with mcp-tui  
mcp-tui ./mcp-debug --proxy --config empty-config.yaml

🎯 Core Workflow

1. Start MCP Debug proxy
2. Add servers dynamically with server_add
3. Test and iterate on your MCP servers
4. Hot-swap binaries with server_disconnect/server_reconnect
5. Record sessions for regression testing
6. Automate testing with playback modes

🏗️ Use Cases

• MCP Server Development - Hot-swap servers during development
• Multi-Server Integration - Test interactions between MCP servers
• Regression Testing - Record working sessions, replay for testing
• Client Development - Test clients against recorded server responses

Perfect for developers building the MCP ecosystem! 🚀

📚 Documentation

See README.md for comprehensive documentation and examples.

---

Built for MCP developers, by MCP developers.