Metadata-Version: 2.4
Name: debug-mcp-server-launcher
Version: 0.15.8
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
