-
securityA
license-
qualityProvides 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 -
9
MIT License
Enables making HTTP requests directly from the shell for API interactions and file downloads
Allows execution of Git commands for version control operations like checking status, committing changes, and managing repositories
Provides access to Make build automation tool for compiling and building projects
Provides access to Node package management commands for installing, updating, and managing JavaScript dependencies
Supports package management via pip for installing and managing Python dependencies
Supports running Python scripts and commands directly through the shell executor
Allows building and managing Rust projects through cargo and rustc commands
Provides safe execution of various shell utilities and commands with whitelist-based filtering
Enables interaction with the Yarn package manager for JavaScript projects, allowing dependency management operations
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,dffile,stat,pwd
Text Processing
grep,sed,awk,sort,uniq,cut,tr
Development
git,npm,yarn,pip,python,node,cargo,makerustc,go,java,javac
System Info
ps,uptime,whoami,id,uname,which
Network
curl,wget,ping,dig,nslookup
Archives
tar,zip,unzip,gzip,gunzip
Utilities
echo,date,cal,bc,expr,basename,dirnameHash 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
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -116Apache 2.0
- -securityAlicense-qualityTransform 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 -13MIT License
- -securityAlicense-qualityAllows AI assistants to safely execute common Unix/macOS terminal commands through a controlled interface with comprehensive security features.Last updated -6MIT License