Command Execution MCP Server for Claude Desktop
Overview
The Command Execution MCP (Model Context Protocol) Server is a secure, controlled tool that allows Claude to execute shell commands directly on your local system. This server provides a safe and flexible way to interact with your computer's command line through Claude's interface.
Key Features
- Secure Command Execution : Runs shell commands with built-in safety checks
- Working Directory Support : Execute commands in specific directories
- Cross-Platform Compatibility : Works on macOS and other Unix-like systems
- Extensive Error Handling : Provides detailed feedback on command execution
- Timeout and Buffer Limits : Prevents runaway or resource-intensive commands
Security Measures
The server implements multiple layers of security:
- Dangerous Command Blocking
* Prevents execution of potentially harmful commands like `rm -rf`, `sudo`, etc.
* Blocks commands that could compromise system integrity
- Execution Constraints
* Maximum execution time: 30 seconds
* Maximum output buffer: 1MB
* Validates working directory existence
Supported Tools
1. execute-command
Execute shell commands with optional working directory specification.
Parameters:
command
(required): The shell command to execute
workingDirectory
(optional): Specify the directory for command execution
Example Usage in Claude:
execute-command with command="ls -la" and workingDirectory="/Users/yourusername/Documents"
2. simple-hello
A basic demonstration tool that returns a greeting.
Parameters:
name
(optional): Name to greet (defaults to "World")
Example Usage in Claude:
simple-hello with name="Claude"
Installation
1. Prerequisites
- Node.js (v16 or later)
- Claude Desktop
- npm (Node Package Manager)
2. Install Dependencies
cd /path/to/command-execution-tool
npm install @modelcontextprotocol/sdk
3. Claude Desktop Configuration
Add the following to your Claude Desktop configuration file:
Location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Configuration Block:
{
"mcpServers": {
"command-execution": {
"command": "node",
"args": [
"/full/path/to/command-execution-tool.js"
],
"env": {
"NODE_OPTIONS": "--no-deprecation"
}
}
}
}
Important: Replace /full/path/to/command-execution-tool.js
with the actual path to the script.
Usage Guidelines
- Be Cautious : Only run commands you understand
- Security First : The tool prevents obviously dangerous commands
- Working Directory : Specify a working directory for more controlled execution
Limitations
- Does not support interactive commands
- Maximum command execution time is 30 seconds
- Output is limited to 1MB
- Some system-critical commands are blocked
Contributing
Contributions are welcome! Please submit pull requests or open issues on the GitHub repository.
License
MIT License
Support
For issues or feature requests, please open a GitHub issue.