ES

egoist/shell-command-mcp

Developer tools
66 stars 6 forks Quality 45 Trend 14

MCP server for executing shell commands.

Overview

MCP server for executing shell commands. This project is sponsored by ChatWise, an all-in-one LLM chatbot with first-class MCP support. Use ALLOWED_COMMANDS environment variable to explictly allow the commands that this server can run, separate each command by ,. You can use * to allow any command, but this is potentially dangerous.

README

shell-command-mcp

MCP server for executing shell commands.

This project is sponsored by ChatWise, an all-in-one LLM chatbot with first-class MCP support.

Usage

Configure manually

# stdio server
npx -y shell-command-mcp

JSON config

{
  "mcpServers": {
    "shell-command": {
      "command": "npx",
      "args": ["-y", "shell-command-mcp"],
      "env": {
        "ALLOWED_COMMANDS": "cat,ls,echo"
      }
    }
  }
}

Allowed commands

Use ALLOWED_COMMANDS environment variable to explictly allow the commands that this server can run, separate each command by ,. You can use * to allow any command, but this is potentially dangerous.

License

MIT.

View the full README on GitHub

Install

npx -y shell-command-mcp
New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "shell-command": { "command": "npx", "args": ["-y", "shell-command-mcp"], "env": { "ALLOWED_COMMANDS": "cat,ls,echo" } } } }