execLABSCO SUMMARY
Shell access, and the author does not soften what that means.
The author calls it a Pandora's box, and the reasoning is sound: the tool can run anything the launching user can, and the forbidden-word list can be bypassed rather than relied on. The configuration is the interesting part — pointing it at psql instead of a shell gives you a database tool with a narrow blast radius, which is a far better default than a general shell. Run it in an isolated or controlled environment, and scope the launched process as tightly as the job allows.
What it is
A Python MCP server that opens a long-lived process and exposes a single tool for running commands through it. The process is whatever you configure, so the same server becomes a WSL shell, a psql session, or another CLI entirely.
What you get
- One exec tool per server entry, running a static command and returning its output
--process-path-args— the process and its initial arguments, which is what decides whether this is a shell or a database client--exec-nameand--exec-description, so the tool the model sees is named for the job it does--forbidden-words— a list of words rejected in commands--filter-patterns— regexes that strip terminal noise such as ANSI colour sequences and window titles from the output--exec-timeout, defaulting to 60 seconds- Register the same server twice with different processes to get two differently named tools
Requirements
Python 3.10 or higher, 3.11+ recommended. On Windows the pywinpty package is required; on Linux and macOS, ptyprocess. Install with pip install .. The author reports testing only against WSL.
Setup effort
Build from source — git clone https://github.com/jrame/mcp-process.git
USE CASES
01
Letting the assistant look around a project
Point the process at your shell with a starting directory and keep the commands read-shaped.
02
Querying a database without a database server
Register a second entry pointing at psql with its connection string, named so the model knows what it is for.
03
Getting readable output back
Add filter patterns for ANSI colour codes so the model sees text rather than escape sequences.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
Python 3.10 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/jrame/mcp-process.git
cd mcp-process
pip install .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"wsl": {
"command": "mcp-process",
"args": [
"--process-path-args",
"wsl.exe --cd /mnt/c/Users/<YOUR_USERNAME>",
"--exec-name",
"exec",
"--exec-timeout",
"60"
]
}
}
}
