Shell Command MCP Server

Servidor MCP de Comandos Shell

Servidor em Go que implementa o Model Context Protocol (MCP) para executar comandos shell.

Recursos

• Executar comandos shell usando bash ou zsh
• Listar execuções de comandos anteriores
• Recursos de segurança para limitar comandos permitidos
• Configurar o conjunto de comandos permitidos para segurança

Nota: O servidor só permitirá a execução de comandos especificados por meio do parâmetro allowedCommands ou todos os comandos se configurado com "*".

API

Ferramentas

• execute_command

  • Executar um comando shell
  • Entrada:
    • command (string): O comando a ser executado
    • shell (string, opcional): O shell a ser usado (bash ou zsh, padrão é bash)
  • Saída:
    • Saída do comando com stdout e stderr
    • Código de saída
    • Tempo de execução

• list_recent_commands

  • Listar comandos executados recentemente
  • Entrada:
    • limit (inteiro, opcional): Número de comandos a retornar (padrão é 10)
  • Saída:
    • Lista de comandos executados recentemente com carimbos de data/hora e status

• list_allowed_commands

  • Listar todos os comandos que o servidor está autorizado a executar
  • Nenhuma entrada necessária
  • Retorna:
    • Lista de comandos permitidos ou "*" se todos os comandos forem permitidos

Uso com o Claude Desktop

Instale o servidor

go install github.com/gamunu/mcp-unix-shell

Adicione isso ao seu claude_desktop_config.json:

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

Para permitir todos os comandos (use com cautela):

{
  "mcpServers": {
    "shell": {
      "command": "mcp-unix-shell",
      "args": [
        "--allowed-commands=*"
      ]
    }
  }
}

Considerações de Segurança

Ao usar este servidor MCP, considere:

1. Permita apenas comandos em que você confia - uma lista de permissões restritiva é recomendada
2. Evite permitir comandos que possam modificar configurações do sistema ou acessar dados sensíveis
3. O servidor executa com as permissões do usuário que está executando o Claude Desktop
4. A saída do comando é enviada de volta ao LLM, portanto, esteja atento a informações sensíveis

Licença

Este servidor MCP é licenciado sob a Apache License 2.0.