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.

Warning / Disclaimer

⚠️ CAUTION ⚠️

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.

Features

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

Prerequisites

Python 3.10 or higher (Python 3.11+ recommended)
WSL installed and configured
On Windows, the pywinpty package is required
On Linux/Mac, the ptyprocess package is required

Installation

Clone the repository:

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

Install the package:

pip install .

Or for development installation:

pip install -e ".[dev]"

Claude Configuration

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

Add the following section:

*Configuration content*

Option	Description	Default Value
`--process-path-args`	Path to shell process including initial arguments (e.g., `wsl.exe --cd [dir]`)	`wsl.exe --cd [current_dir]`
`--forbidden-words`	List of words not allowed in commands	`[several_default_items]`
`--filter-patterns`	Regex patterns to filter	`["\x07", "\x1b\[25l"]`
`--exec-name`	Custom name for the exec tool	`exec`
`--exec-description`	Custom description for the exec tool	(see default in args)
`--exec-timeout`	Command timeout (in sec.)	60

Filter Examples

To filter ANSI color sequences:

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

To filter terminal titles:

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

Usage

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

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

Development

To contribute to development:

Clone the repository

Install development dependencies:

pip install -e ".[dev]"

Run tests:
```
pytest
```

License

MIT

Contact

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

Similar Projects and Resources

Here is a list of similar projects that also provide MCP servers for shell access:

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

MCP Process