MCP Unix Shell MCP Server

Go server implementing Model Context Protocol (MCP) for executing shell commands.

Local serverstdioGo

What is the MCP Unix Shell MCP Server?

Go server implementing Model Context Protocol (MCP) for executing shell commands.

Key capabilities

  • Execute shell commands using bash or zsh
  • List previous command executions
  • Safety features to limit allowed commands
  • Configure allowed command set for security

Practical notes

  • Maintained by gamunu, written in Go.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute_commandExecute a shell command
Input:limit (integer, optional): Number of commands to return (defaults to 10)
shellstring, optional): The shell to use (bash or zsh, defaults to bash)
Output:List of recently executed commands with timestamps and status
list_recent_commandsList recently executed commands
list_allowed_commandsList all commands that the server is allowed to execute
Returns:List of allowed commands or "" if all commands are allowed

How to install the MCP Unix Shell MCP Server

{
  "mcpServers": {
    "shell": {
      "command": "mcp-unix-shell",
      "args": [
        "--allowed-commands=ls,cat,echo,find"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use MCP Unix Shell to execute command.”
  • “Use MCP Unix Shell to Input.”
  • “Use MCP Unix Shell to Output.”

Frequently asked questions

Go server implementing Model Context Protocol (MCP) for executing shell commands. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.