Shell Executor MCP Server

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

Features

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

Installation

Option 1: Direct Usage

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

Option 2: Install from PyPI (when published)

pip install shell-executor-mcp

VS Code Integration

1. Global Configuration

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"
      }
    }
  }
}

2. Workspace Configuration

Create .vscode/mcp_servers.json in your workspace:

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

3. Using with VS Code Copilot

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

Manual Testing

Start the server:

python src/mcp_server.py

Send test requests:

Initialize:

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

List tools:

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

Execute command:

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

Supported Commands

File System

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

Text Processing

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

Development

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

System Info

ps, uptime, whoami, id, uname, which

Network

curl, wget, ping, dig, nslookup

Utilities

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

Security

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

Configuration

Set environment variables:

MCP_API_TOKEN: Authentication token (default: "MYSECRET")

License

MIT License - see LICENSE file for details.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides safe shell command execution capabilities for AI agents and tools like VS Code Copilot through a whitelist-based filtering system.

Related MCP Servers

CodeSavant
twolven
-
security
A
license
-
quality
Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
Last updated -
8
Python
MIT License
Shell MCP Server
blazickjp
-
security
A
license
-
quality
A secure server that enables AI applications to execute shell commands in specified directories, supporting multiple shell types (bash, sh, cmd, powershell) with built-in security features like directory isolation and timeout control.
Last updated -
9
Python
Apache 2.0
UltimateCoder
m-ahmed-elbeskeri
-
security
-
license
-
quality
Transform your local machine into a powerful code command center. Automate file handling, run terminal commands, and leverage AI to enhance your development workflows—all securely and instantly, without cloud latency.
Last updated -
1
Python
MIT License
Command-Line MCP Server
andresthor
-
security
A
license
-
quality
Allows AI assistants to safely execute common Unix/macOS terminal commands through a controlled interface with comprehensive security features.
Last updated -
Python
MIT License

View all related MCP servers

Shell Executor MCP Server