| Name | debug-mcp-server-launcher JSON |
| Version |
0.11.2
JSON |
| download |
| home_page | None |
| Summary | Launcher for debug-mcp-server. This package ensures debugpy is installed and provides instructions to run the main server (Node.js or Docker). |
| upload_time | 2025-07-21 09:38:39 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
mcp
dap
debugger
debugpy
ai-agent
llm
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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
Raw data
{
"_id": null,
"home_page": null,
"name": "debug-mcp-server-launcher",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, dap, debugger, debugpy, ai-agent, llm",
"author": null,
"author_email": "debugmcp <debug@sycamore.llc>",
"download_url": "https://files.pythonhosted.org/packages/42/1d/896c1eed39b0a005d8df4f5f0cfb1ddc710719bca0ec7f4f1f0a48c72b9f/debug_mcp_server_launcher-0.11.2.tar.gz",
"platform": null,
"description": "# debug-mcp-server-launcher\n\nA Python launcher for the debug-mcp-server, providing step-through debugging capabilities for LLM agents.\n\n## Overview\n\nThis launcher simplifies running the debug-mcp-server by:\n- Auto-detecting available runtimes (Node.js/npm or Docker)\n- Automatically launching the server with the appropriate runtime\n- Handling process lifecycle and graceful shutdowns\n- Providing clear error messages and installation guidance\n\n## Installation\n\n```bash\npip install debug-mcp-server-launcher\n```\n\nThis will install the launcher and ensure `debugpy` (required for Python debugging) is available.\n\n## Usage\n\n### Basic Usage\n\n```bash\n# Launch in stdio mode (default)\ndebug-mcp-server\n\n# Launch in SSE mode\ndebug-mcp-server sse\n\n# SSE mode with custom port\ndebug-mcp-server sse --port 8080\n```\n\n### Runtime Selection\n\nThe launcher automatically detects and uses the best available runtime:\n1. **npm/npx** (preferred) - if Node.js is installed\n2. **Docker** (fallback) - if Docker is installed and running\n\nYou can force a specific runtime:\n\n```bash\n# Force Docker mode\ndebug-mcp-server --docker\n\n# Force npm mode \ndebug-mcp-server --npm\n```\n\n### Other Options\n\n```bash\n# Show what command would be executed\ndebug-mcp-server --dry-run\n\n# Enable verbose output\ndebug-mcp-server --verbose\n\n# Show version\ndebug-mcp-server --version\n\n# Show help\ndebug-mcp-server --help\n```\n\n## Requirements\n\n### For npm/npx mode:\n- Node.js 16+ installed\n- The launcher will automatically download the server package via npx\n\n### For Docker mode:\n- Docker installed and running\n- The launcher will automatically pull the image if needed\n\n### For Python debugging:\n- `debugpy` is automatically installed with this package\n\n## Transport Modes\n\n- **stdio**: Standard input/output communication (default)\n- **sse**: Server-Sent Events mode for HTTP-based communication\n - Default port: 3001\n - Custom port: Use `--port` option\n\n## Troubleshooting\n\nIf you encounter issues:\n\n1. **\"No suitable runtime found\"**\n - Install Node.js from https://nodejs.org (recommended)\n - Or install Docker from https://docker.com\n\n2. **\"Docker daemon is not running\"**\n - Start Docker Desktop\n - Or use npm mode: `debug-mcp-server --npm`\n\n3. **\"npx command not found\"**\n - Ensure Node.js is properly installed\n - npx typically comes with npm (Node.js package manager)\n\n## Development\n\nThis is a launcher package for the main debug-mcp-server project. For server development and contributions, see:\nhttps://github.com/debugmcp/mcp-debugger\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": null,
"summary": "Launcher for debug-mcp-server. This package ensures debugpy is installed and provides instructions to run the main server (Node.js or Docker).",
"version": "0.11.2",
"project_urls": {
"Homepage": "https://github.com/debugmcp/mcp-debugger",
"Repository": "https://github.com/debugmcp/mcp-debugger"
},
"split_keywords": [
"mcp",
" dap",
" debugger",
" debugpy",
" ai-agent",
" llm"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "212b3d4f3755e3508399fac37d3353bddf4da5a343274505f81395d3d5797422",
"md5": "c7e9fdf4daf2a8d23164d1c485d15ada",
"sha256": "2f80937a10ee2b79594ea9d9f40b12f89743e01f48237a7132abedf29860bbae"
},
"downloads": -1,
"filename": "debug_mcp_server_launcher-0.11.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c7e9fdf4daf2a8d23164d1c485d15ada",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 10255,
"upload_time": "2025-07-21T09:38:38",
"upload_time_iso_8601": "2025-07-21T09:38:38.227773Z",
"url": "https://files.pythonhosted.org/packages/21/2b/3d4f3755e3508399fac37d3353bddf4da5a343274505f81395d3d5797422/debug_mcp_server_launcher-0.11.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "421d896c1eed39b0a005d8df4f5f0cfb1ddc710719bca0ec7f4f1f0a48c72b9f",
"md5": "9b07475a93ac6f8d630ec93c4019f545",
"sha256": "53a1d27cb132a73f6c004fbfec5e13fe44abb5368cc6d439bf3d8e5bc129e35a"
},
"downloads": -1,
"filename": "debug_mcp_server_launcher-0.11.2.tar.gz",
"has_sig": false,
"md5_digest": "9b07475a93ac6f8d630ec93c4019f545",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 8809,
"upload_time": "2025-07-21T09:38:39",
"upload_time_iso_8601": "2025-07-21T09:38:39.297343Z",
"url": "https://files.pythonhosted.org/packages/42/1d/896c1eed39b0a005d8df4f5f0cfb1ddc710719bca0ec7f4f1f0a48c72b9f/debug_mcp_server_launcher-0.11.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-21 09:38:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "debugmcp",
"github_project": "mcp-debugger",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "debug-mcp-server-launcher"
}
