@supercorp/shell-mcp

An MCP server that gives AI agents shell access. Provides a run_command tool for executing shell commands and returning stdout, stderr, and exit code.

Supports Streamable HTTP, SSE, and stdio transports.

Quick start

npx @supercorp/shell-mcp

This starts an HTTP server on port 8000.

Related MCP server: Terminal MCP Server

Usage

Streamable HTTP (default)

npx @supercorp/shell-mcp --port 3000

SSE

npx @supercorp/shell-mcp --transport sse --port 3000

stdio

npx @supercorp/shell-mcp --transport stdio

Options

Tool

run_command

Execute a shell command.

Parameters:

Response:

{
  "stdout": "hello world\n",
  "stderr": "",
  "exitCode": 0
}

Commands have a 60-second timeout and 10 MB output buffer.

MCP client configuration

Claude Desktop

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": ["-y", "@supercorp/shell-mcp", "--transport", "stdio"]
    }
  }
}

HTTP client

{
  "mcpServers": {
    "shell": {
      "url": "http://localhost:8000/"
    }
  }
}

License

ISC