run_process
Run a process on this linux machine
LABSCO SUMMARY
It is a shell, and its one tool is honest about being one.
run_process takes argv or command_line, cwd, stdin_text and timeout_ms and gives back what the process printed, which is the whole surface of a terminal behind a single call. Nothing in those parameters narrows what may run, so the boundary is the account it was started under and the machine it sits on. That shape suits a container or a scratch VM, and it is the wrong shape for a workstation that holds credentials.
What it is
A single-tool server that runs a process on the machine hosting it and returns what that process produced.
What you get
- A process started either from an argv list or from a command_line string, so quoting is your choice rather than the server's
- A cwd per call, so a command runs where the files it needs are
- Text handed to the process on stdin, which covers everything that reads input rather than arguments
- A timeout_ms per call, bounding anything that will not finish
Requirements
A Linux host you are willing to let a model start processes on, and no account or key of any kind. The user account the server was started under is what those processes get. MIT.
Setup effort
One command — npx mcp-server-commands
USE CASES
01
Running the build and reading the failure that comes back
Start the command in the directory it belongs to, cap it with a timeout so a hanging build does not hang the conversation, and read what it printed.
02
Piping text through a tool that has no server of its own
Content is handed to the process on stdin rather than written to a file first, which covers the long tail of command-line tools that read input rather than arguments.
1 tool
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the one tool definition that rides along on every turn
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-server-commands": {
"command": "npx",
"args": [
"mcp-server-commands"
]
}
}
}npx
TERMINAL
npx mcp-server-commands
