Runtimes Python, pipx y source¶
Los runtimes Python son útiles para desarrollo, depuración y entornos donde gestionar paquetes Python es más sencillo que usar Docker. Ejecutan el mismo servidor que los runtimes Docker y binary.
Use esta página para tres casos relacionados:
pipx install local-shell-mcp: instalación de executable a nivel de usuario.pip install local-shell-mcp: instalación en un virtual environment existente.- Editable source checkout: desarrollar o depurar el propio proyecto.
Instalación con pipx¶
pipx es la instalación basada en Python más limpia para usuarios normales porque da al comando su propio virtual environment y expone a la vez un executable en PATH.
Inicie un servidor MCP HTTP local:
mkdir -p ~/local-shell-mcp-workspace
export LOCAL_SHELL_MCP_WORKSPACE_ROOT=~/local-shell-mcp-workspace
local-shell-mcp --mode mcp
Compruebe el estado:
Instalación en virtual environment¶
Úsela cuando ya gestione manualmente sus entornos Python:
python -m venv .venv
. .venv/bin/activate
pip install --upgrade pip
pip install local-shell-mcp
local-shell-mcp --mode mcp
El proceso usa las herramientas instaladas en el host. El paquete Python no instala por usted compiladores, Git, dependencias de sistema del navegador ni dependencias del proyecto.
Editable source checkout¶
Úselo para desarrollar el proyecto:
git clone https://github.com/fwerkor/local-shell-mcp.git
cd local-shell-mcp
python -m venv .venv
. .venv/bin/activate
pip install --upgrade pip
pip install -e '.[dev,docs]'
LOCAL_SHELL_MCP_WORKSPACE_ROOT=/tmp/local-shell-mcp-workspace local-shell-mcp --mode mcp
Ejecute las comprobaciones:
Configuración del navegador¶
El paquete Python depende de Playwright, pero quizá deba instalar los browser binaries en el host:
Algunos hosts Linux necesitan dependencias de navegador adicionales. Docker evita gran parte de esto porque la imagen parte de una Playwright base image.
Uso público de HTTP MCP¶
Para ChatGPT u otro public HTTP MCP client, configure el mismo public origin y OAuth que en otros runtimes HTTP y exponga el puerto local mediante un reverse proxy o tunnel.
El endpoint MCP público es:
Modos de desarrollo¶
| Mode | Command | Uso |
|---|---|---|
| MCP HTTP | local-shell-mcp --mode mcp |
MCP clients completos por HTTP, incluido ChatGPT detrás de HTTPS |
| REST-style HTTP | local-shell-mcp --mode http |
Endpoints de diagnóstico o compatibilidad, no la ruta principal de ChatGPT |
| stdio | local-shell-mcp --mode stdio |
MCP clients locales que inician el proceso |
mode=both está reservado y actualmente no debe usarse como modo de un único process.
Seguridad del host runtime¶
Las instalaciones Python se ejecutan como su usuario del host salvo que las coloque en una VM o container. Mantenga el workspace limitado, full-container mode desactivado y no apunte el workspace a un home directory.
Use Docker Compose para repositories no confiables, tareas intensivas en package manager o workflows donde la capacidad de reset sea más importante que la integración con el host.