Shell Executor

A Model Context Protocol (MCP) server that provides safe shell command execution capabilities for AI agents and tools like VS Code Copilot.

- Safe Command Execution: Whitelist-based command filtering
- Comprehensive Tool Set: Support for file operations, text processing, development tools, and system utilities
- MCP Compatible: Full Model Context Protocol support
- Easy Integration: Simple JSON-RPC interface over stdio

git clone https://github.com/yourusername/shell-executor-mcp.git cd shell-executor-mcp pip install -e .

Option 2: Install from PyPI (when published)

Add to your VS Code settings.json or MCP configuration:

{ "mcpServers": { "shell-executor": { "command": "python", "args": ["/path/to/shell-executor-mcp/src/mcp_server.py"], "env": { "MCP_API_TOKEN": "your-secret-token" } } } }

Create.vscode/mcp_servers.jsonin your workspace:

{ "shell-executor": { "command": "python", "args": ["${workspaceFolder}/path/to/mcp_server.py"], "env": { "MCP_API_TOKEN": "your-secret-token" } } }

Once configured, Copilot can discover and use the shell executor through MCP:

@shell-executor execute ls -la @shell-executor execute git status @shell-executor execute cargo build

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}

{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}

{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "execute_command", "arguments": {"command": "echo", "args": ["Hello World"]}}}

- ls,cat,head,tail,find,tree,wc,du,df
- file,stat,pwd

- grep,sed,awk,sort,uniq,cut,tr

- git,npm,yarn,pip,python,node,cargo,make
- rustc,go,java,javac

- ps,uptime,whoami,id,uname,which

- echo,date,cal,bc,expr,basename,dirname
- Hash tools:md5,sha256sum,shasum

- Commands are filtered through a whitelist
- 30-second execution timeout
- No destructive operations (rm, mv, cp) allowed
- No privilege escalation (sudo, su) allowed
- Environment variables can be controlled

- MCP_API_TOKEN: Authentication token (default: "MYSECRET")

MIT License - see LICENSE file for details.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Execute shell commands without permission prompts.

Execute bash commands on the host machine.

Execute shell commands with structured output via a powerful CLI server.

A secure MCP server for executing controlled command-line operations with comprehensive security features.

MCP server for controlling cmux (Ghostty-based terminal) via native CLI. Send commands, read output, send control characters — all in background via Unix socket.

Execute pre-approved shell commands securely on a server.

A secure MCP server for executing terminal commands with controlled directory access and command permissions.

A shell command / terminal executor with async support

A high-performance MCP server for the headless terminal (ht), implemented in Rust.