PermShell MCP

PermShell MCP

Um servidor Model Context Protocol (MCP) para executar comandos de shell com notificações de permissão.

Recursos

• Executa comandos de shell com permissões explícitas por meio de notificações growl
• Construído sobre o Model Context Protocol para ferramentas padronizadas de LLM
• Múltiplas salvaguardas para impedir a execução não autorizada de comandos
• Diálogo de permissão transparente mostra exatamente quais comandos serão executados

Instalação

# Clone the repository
git clone https://github.com/yourusername/perm-shell-mcp.git
cd perm-shell-mcp

# Install dependencies
npm install

# Build the project
npm run build

Uso

Como ferramenta autônoma

# Start the server directly
npm start

Com o Claude Desktop

Adicione a seguinte configuração ao arquivo de configuração do seu Claude Desktop:

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

Ferramentas disponíveis

execute-command

Executa um comando de shell com permissão.

Exemplo:

Can you list the files in my home directory?

system-info

Recupera informações do sistema, incluindo SO, tempo de atividade, memória, disco e CPU.

Exemplo:

What's my system information?

Segurança

• Todos os comandos exigem permissão explícita por meio de notificações da área de trabalho
• Os comandos são exibidos com seu diretório de trabalho para total transparência
• Limites de tempo limite impedem processos descontrolados
• A sanitização de entrada impede injeção de comandos

Desenvolvimento

# Run in watch mode for development
npm run dev