MCP-PROCESS

An MCP server (Model-Client-Protocol) allowing Claude to access a shell. This integration enables Claude to execute commands and interact with your file system via the command line.

This project has only been tested with WSL (Windows Subsystem for Linux) and has not been validated for production use. Using this MCP gives Claude direct access to your file system and shell, which presents significant security risks:

- It can potentially delete or modify critical files
- It can execute any command accessible to the user under which it runs
- The built-in security measures (such as the list of forbidden words) can be bypassed

This is truly a Pandora's box- use it at your own risk. The author assumes no responsibility for damages, data loss, or security issues resulting from the use of this software.

It is strongly recommended to use it only in an isolated or controlled environment.

- Execution of static commands
- Validation of potentially dangerous commands
- Flexible configuration of command filtering and timeout

- Python 3.10 or higher (Python 3.11+ recommended)
- WSL installed and configured
- On Windows, thepywinptypackage is required
- On Linux/Mac, theptyprocesspackage is required

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

To use this MCP server with Claude, you need to add the following configuration to Claude's configuration file. Depending on your installation, this file is usually located at:

%AppData%/Claude/claude_desktop_config.json

"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" ] } }

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

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

Once installed and configured, you can ask Claude to execute WSL commands as follows:

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

- Clone the repository
- Install development dependencies:

pip install -e ".[dev]"

For any questions, bug reports, or suggestions, please create an issue on the project's GitHub repository. GitHub repository:https://github.com/Metherlance/mcp-process

- mcp-server-commands- An MCP server for executing system commands
- mcp-process-server- A TypeScript implementation of an MCP server for shell
- mcp-server-shell- An MCP server for shell interactions

Model Context Protocol server for secure AsusWRT router administration via SSH. Provides 42+ read-only monitoring tools and guarded mutation tools for managing AsusWRT/Merlin routers.