MCP-PROCESS

Proporciona acceso a la shell para ejecutar comandos e interactuar con el sistema de

Documentación

MCP-PROCESS

Un servidor MCP (Model-Client-Protocol) que permite a Claude acceder a un shell. Esta integración permite que Claude ejecute comandos e interactúe con su sistema de archivos a través de la línea de comandos.

Advertencia / Descargo de responsabilidad

⚠️ PRECAUCIÓN ⚠️

Este proyecto solo ha sido probado con WSL (Subsistema de Windows para Linux) y no ha sido validado para uso en producción. El uso de este MCP le da a Claude acceso directo a su sistema de archivos y shell, lo que presenta riesgos de seguridad significativos:

Puede potencialmente eliminar o modificar archivos críticos
Puede ejecutar cualquier comando accesible para el usuario bajo el cual se ejecuta
Las medidas de seguridad integradas (como la lista de palabras prohibidas) pueden ser eludidas

Esto es verdaderamente una caja de Pandora: úselo bajo su propio riesgo. El autor no asume ninguna responsabilidad por daños, pérdida de datos o problemas de seguridad derivados del uso de este software.

Se recomienda encarecidamente usarlo solo en un entorno aislado o controlado.

Características

Ejecución de comandos estáticos
Validación de comandos potencialmente peligrosos
Configuración flexible del filtrado de comandos y tiempo de espera

Requisitos previos

Python 3.10 o superior (se recomienda Python 3.11+)
WSL instalado y configurado
En Windows, se requiere el paquete pywinpty
En Linux/Mac, se requiere el paquete ptyprocess

Instalación

Clone el repositorio:

git clone https://github.com/jrame/mcp-process.git
cd mcp-process

Instale el paquete:

pip install .

O para instalación de desarrollo:

pip install -e ".[dev]"

Configuración de Claude

Para usar este servidor MCP con Claude, debe agregar la siguiente configuración al archivo de configuración de Claude. Dependiendo de su instalación, este archivo generalmente se encuentra en:

%AppData%/Claude/claude_desktop_config.json

Agregue la siguiente sección:

"mcpServers": {
  "wsl": {
    "command": "mcp-process",
    "args": [
      "--process-path-args", "wsl.exe --cd /mnt/c/Users/YourName",
      "--filter-patterns", "\\x1b\\[[0-9;]*m",
      "--exec-name", "exec",
      "--exec-description", "Exécute une commande statique (ls pwd cat tree ps mkdir cp grep find git sed echo rg ...) et retourne son résultat",
      "--exec-timeout", "60"
    ]
  },
  "psql": {
    "command": "mcp-process",
    "args": [
      "--process-path-args", "psql.exe postgresql://postgres:password@localhost:5432/db",
      "--exec-name", "psql",
      "--exec-description", "Exécute une commande statique sql et retourne son résultat ex: -c \"SELECT * FROM table;\" ",
      "--exec-timeout", "120"
    ]
  }
}

Opción	Descripción	Valor predeterminado
`--process-path-args`	Ruta al proceso de shell incluidos los argumentos iniciales (p. ej., `wsl.exe --cd [dir]`)	`wsl.exe --cd [current_dir]`
`--forbidden-words`	Lista de palabras no permitidas en los comandos	`[several_default_items]`
`--filter-patterns`	Patrones de expresiones regulares para filtrar	`["\x07", "\x1b\[25l"]`
`--exec-name`	Nombre personalizado para la herramienta exec	`exec`
`--exec-description`	Descripción personalizada para la herramienta exec	(ver predeterminado en args)
`--exec-timeout`	Tiempo de espera del comando (en segundos)	60

Ejemplos de filtros

Para filtrar secuencias de color ANSI:

--filter-patterns "\x1b\[[0-9;]*m"

Para filtrar títulos de terminal:

--filter-patterns "\x1b\]0;.*?\x07"

Uso

Una vez instalado y configurado, puede pedirle a Claude que ejecute comandos WSL de la siguiente manera:

Can you run the command "ls -la" in WSL?

Desarrollo

Para contribuir al desarrollo:

Clone el repositorio
Instale las dependencias de desarrollo:
```
pip install -e ".[dev]"
```
Ejecute las pruebas:
```
pytest
```

Licencia

MIT

Contacto

Para cualquier pregunta, informe de errores o sugerencia, cree un problema en el repositorio de GitHub del proyecto. Repositorio de GitHub: https://github.com/Metherlance/mcp-process

Proyectos y recursos similares

Aquí hay una lista de proyectos similares que también proporcionan servidores MCP para acceso al shell:

mcp-server-commands - Un servidor MCP para ejecutar comandos del sistema
mcp-process-server - Una implementación en TypeScript de un servidor MCP para shell
mcp-server-shell - Un servidor MCP para interacciones con el shell