Shell MCP

🚀 Shell Command Execution MCP Server

A secure MCP server for executing shell commands in large language models (LLMs)

An MCP server implementation that provides secure shell command execution capabilities for LLMs.

✨ Features

• Secure Execution: Only commands and parameters in the whitelist are allowed.
• Resource Control: Monitor memory and CPU usage.
• Timeout Control: Automatically terminate long - running commands.
• Size Limit: Limit the size of output results to ensure security.
• MCP Integration: Use with Claude and other MCP - compatible LLMs.

📦 Installation

npm install @kevinwatt/shell-mcp

Configuration with Dive Desktop

1. Click "+ Add MCP Server" in Dive Desktop.
2. Copy and paste the following configuration:

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/shell-mcp"
      ]
    }
  }
}

📚 Documentation

• shell_ls, shell_pwd, shell_df, etc.
  • Execute verified shell commands.
  • Input:
    • command (string, required): The command to execute.
    • args (array, optional): Command parameters.
    • timeout (number, optional): Execution timeout in milliseconds.

💻 Usage Examples

Basic Usage

Request your LLM to perform the following operations:

"Show the current directory using shell_pwd"
"List files using shell_ls with the -l parameter"
"Check disk usage using shell_df with the -h parameter"

Manual Startup

If necessary, you can manually start the server:

npx @kevinwatt/shell-mcp

Requirements

• Node.js 18+
• MCP - compatible LLM service

Development

# Install dependencies
npm install

# Watch mode
npm run watch

# Run tests
npm test

# Check code style
npm run lint

📄 License

MIT © Devi Yan

Keywords

• mcp
• shell
• command
• claude
• llm
• automation

Available Commands

Note: All commands need to pass the whitelist verification before execution.