MCP server for remote shell and file operations. Cross-platform (Windows/macOS/Linux). Streamable HTTP transport.
Quick Install
Copy the config for your editor. Some servers may need additional setup — check the README.
Add to claude_desktop_config.json:
{
"mcpServers": {
"shell-mcp": {
"command": "uvx",
"args": [
"shell-mcp"
]
}
}
}
Run in terminal:
claude mcp add shell-mcp uvx shell-mcp
Add to .cursor/mcp.json:
{
"mcpServers": {
"shell-mcp": {
"command": "uvx",
"args": [
"shell-mcp"
]
}
}
}
Or install with pip: pip install shell-mcp
README Excerpt
Remote shell + file operations MCP server. Core is pure stdlib (fully unit-testable); only `server.py` depends on `mcp` / `starlette` / `uvicorn`. - **Streamable HTTP** at `/mcp` (POST). No long-lived connections, safe behind buffered reverse proxies. - **Bearer token auth** (constant-time compare) + optional IP allowlist + `/health` endpoint.
Tools (20)
SHELL_MCP_ALLOWED_IPSSHELL_MCP_ALLOWLISTSHELL_MCP_ENCODINGSHELL_MCP_EXPOSE_GITSHELL_MCP_EXPOSE_LOWLEVELSHELL_MCP_HOSTSHELL_MCP_LOGSHELL_MCP_MAX_CAPTURESHELL_MCP_MAX_LINESSHELL_MCP_MAX_OUTPUTSHELL_MCP_PI_ARGSSHELL_MCP_PI_COMMANDSHELL_MCP_PI_ENABLEDSHELL_MCP_PI_WAIT_SECONDSSHELL_MCP_PORTSHELL_MCP_READONLYSHELL_MCP_SPOOL_MAX_FILESSHELL_MCP_TIMEOUTSHELL_MCP_TOKENSHELL_MCP_UNRESTRICTED
Topics
climcpmcp-servershell