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
Related MCP server: Shell MCP Server
Installation
Option 1: Direct Usage
Option 2: Install from PyPI (when published)
VS Code Integration
1. Global Configuration
Add to your VS Code settings.json or MCP configuration:
2. Workspace Configuration
Create .vscode/mcp_servers.json in your workspace:
3. Using with VS Code Copilot
Once configured, Copilot can discover and use the shell executor through MCP:
Manual Testing
Start the server:
Send test requests:
Initialize:
List tools:
Execute command:
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.