Shell Proxy MCP Server

It sits between AI agents and terminals, executing commands in a clean, controlled environment and returning structured JSON output.

Local serverstdio

What is the Shell Proxy MCP Server?

Shell Proxy is an MCP project maintained in the aliforever/shellproxy repository. The maintainer describes its purpose as “It sits between AI agents and terminals, executing commands in a clean, controlled environment and returning structured JSON output”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using shellproxy. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares SHELLPROXY_SHELL, SHELLPROXY_TIMEOUT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the Shell Proxy MCP Server

{
  "mcpServers": {
    "shellproxy": {
      "command": "shellproxy",
      "args": [
        "serve"
      ],
      "env": {
        "SHELLPROXY_SHELL": "auto",
        "SHELLPROXY_TIMEOUT": "60"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
SHELLPROXY_SHELL	Declared in the maintainer’s client configuration.	Check documentation
SHELLPROXY_TIMEOUT	Declared in the maintainer’s client configuration.	Check documentation