Metadata-Version: 2.4
Name: mcp-debug
Version: 1.1.5
Summary: A debugging and development tool for MCP servers with hot-swapping, session recording, and automated playback testing
Project-URL: Homepage, https://github.com/standardbeagle/mcp-debug
Project-URL: Repository, https://github.com/standardbeagle/mcp-debug
Project-URL: Issues, https://github.com/standardbeagle/mcp-debug/issues
Author: StandardBeagle
License-Expression: MIT
Keywords: debugging,development,mcp,model-context-protocol,proxy
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# MCP Debug

<!-- mcp-name: io.github.standardbeagle/mcp-debug -->

A debugging and development tool for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers.

## Installation

```bash
# 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

```bash
# 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](https://github.com/standardbeagle/mcp-debug) for full documentation.

## License

MIT License
