Metadata-Version: 2.4
Name: debug-mcp-server-launcher
Version: 0.17.0
Summary: Launcher for debug-mcp-server. This package ensures debugpy is installed and provides instructions to run the main server (Node.js or Docker).
Author-email: debugmcp <debug@sycamore.llc>
License-Expression: MIT
Project-URL: Homepage, https://github.com/debugmcp/mcp-debugger
Project-URL: Repository, https://github.com/debugmcp/mcp-debugger
Keywords: mcp,dap,debugger,debugpy,ai-agent,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: debugpy>=1.8.14
Requires-Dist: click>=8.0.0
Dynamic: license-file
# debug-mcp-server-launcher
A Python launcher for the debug-mcp-server, providing step-through debugging capabilities for LLM agents.
## Overview
This launcher simplifies running the debug-mcp-server by:
- Auto-detecting available runtimes (Node.js/npm or Docker)
- Automatically launching the server with the appropriate runtime
- Handling process lifecycle and graceful shutdowns
- Providing clear error messages and installation guidance
## Installation
```bash
pip install debug-mcp-server-launcher
```
This will install the launcher and ensure `debugpy` (required for Python debugging) is available.
## Usage
### Basic Usage
```bash
# Launch in stdio mode (default)
debug-mcp-server
# Launch in SSE mode
debug-mcp-server sse
# SSE mode with custom port
debug-mcp-server sse --port 8080
```
### Runtime Selection
The launcher automatically detects and uses the best available runtime:
1. **npm/npx** (preferred) - if Node.js is installed
2. **Docker** (fallback) - if Docker is installed and running
You can force a specific runtime:
```bash
# Force Docker mode
debug-mcp-server --docker
# Force npm mode
debug-mcp-server --npm
```
### Other Options
```bash
# Show what command would be executed
debug-mcp-server --dry-run
# Enable verbose output
debug-mcp-server --verbose
# Show version
debug-mcp-server --version
# Show help
debug-mcp-server --help
```
## Requirements
### For npm/npx mode:
- Node.js 16+ installed
- The launcher will automatically download the server package via npx
### For Docker mode:
- Docker installed and running
- The launcher will automatically pull the image if needed
### For Python debugging:
- `debugpy` is automatically installed with this package
## Transport Modes
- **stdio**: Standard input/output communication (default)
- **sse**: Server-Sent Events mode for HTTP-based communication
- Default port: 3001
- Custom port: Use `--port` option
## Troubleshooting
If you encounter issues:
1. **"No suitable runtime found"**
- Install Node.js from https://nodejs.org (recommended)
- Or install Docker from https://docker.com
2. **"Docker daemon is not running"**
- Start Docker Desktop
- Or use npm mode: `debug-mcp-server --npm`
3. **"npx command not found"**
- Ensure Node.js is properly installed
- npx typically comes with npm (Node.js package manager)
## Development
This is a launcher package for the main debug-mcp-server project. For server development and contributions, see:
https://github.com/debugmcp/mcp-debugger
## License
MIT
