Desktop Commander MCP

O que é o Desktop Commander MCP?

O Desktop Commander MCP é um servidor de Protocolo de Contexto de Modelo (MCP) que permite interação avançada em nível de sistema entre modelos de linguagem de IA (como Claude Desktop) e sua máquina local. Ele vai muito além de editores de IA típicos, agrupando ferramentas essenciais para desenvolvedores — comandos de terminal, gerenciamento de arquivos, edição de código e automação — em uma interface segura que funciona diretamente através do Claude Desktop, sem exigir créditos de API por token. É projetado para transformar Claude em um assistente de desenvolvedor versátil, capaz de exploração total do código-fonte, mudanças precisas, script de automação e gerenciamento de fluxo de trabalho em todo o seu sistema operacional, não apenas dentro de um IDE.

Como Configurar o Desktop Commander MCP

1. Instale o Claude Desktop: Baixe e instale Claude Desktop.
2. Instalação Rápida via npx: Execute npx @wonderwhy-er/desktop-commander@latest setup no seu terminal.
3. Outras Opções de Instalação:
   • Use a CLI do Smithery com npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
   • Use o script bash para macOS: curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
   • Edite seu claude_desktop_config.json, adicionando a configuração do servidor sob mcpServers
   • Ou clone/construa localmente com git clone ..., npm run setup.
4. Reinicie o Claude Desktop após a configuração para ativar o novo servidor MCP.
5. Configure as Configurações:
   • Use as ferramentas get_config({}) e set_config_value({ key, value }) dentro do chat do Claude para ajustar opções como comandos bloqueados, allowedDirectories, ou shell padrão.
   • Sempre verifique as mudanças de configuração com get_config({}).
   • Para segurança, mantenha um chat de configuração dedicado e especifique limites exatos de acesso a diretórios.

As configurações são persistidas em config.json dentro do diretório de trabalho do servidor. Você pode desativar a telemetria diretamente pedindo ao Claude para "desativar a telemetria" no chat.

Como Usar o Desktop Commander MCP

1. Inicie o Claude Desktop e abra um novo chat.
2. Interaja Usando Linguagem Natural: Peça ao Claude para realizar operações como ler, pesquisar, editar arquivos, executar comandos de terminal ou gerenciar processos — Claude invocará as ferramentas MCP correspondentes.
3. Chamadas Manuais de Ferramentas: Você pode usar os nomes das funções de ferramentas MCP diretamente, por exemplo:

   execute_command({ "command": "ls -la", "shell": "/bin/zsh" })
   read_file({ "path": "README.md" })
   edit_block({ "changes": "...editar formato do bloco..." })
   

4. Gerenciando Tarefas de Longa Duração:
   • Para processos que continuam em segundo plano, use list_sessions para monitorar, read_output para buscar saída de comando, e force_terminate para pará-los.
5. Busca e Edição de Texto/Código:
   • Use a sintaxe de bloco de edição para substituições precisas.
   • Use ferramentas como search_code, search_files e edit_block para realizar e coordenar mudanças sofisticadas no código-fonte.
6. Trocando Shells:
   • Selecione seu shell preferido através do argumento shell nas ferramentas de comando — por exemplo, bash, zsh ou powershell.

A interface permite que você automatize tarefas sem costura, realize scripting de sistema, gerencie arquivos e processos e edite código — tudo através de conversas com o Claude.

Principais Recursos

• Execução de Comandos de Terminal: Execute comandos com saída ao vivo, timeouts e shells customizados.
• Gerenciamento de Processos em Segundo Plano: Liste, monitore e mate processos em execução ou sessões de terminal.
• Gerenciamento de Configuração: Obtenha/defina configurações do servidor, incluindo restrições de comando e acesso a diretórios, sem necessidade de reinicialização.
• Operações de Sistema de Arquivos: Leia, escreva, mova, pesquise e obtenha informações sobre arquivos/diretórios; suporta operações em massa e pesquisas por padrão.
• Busca/Edição Arquivada: Pesquisa de texto/código com múltiplas ocorrências e substituições por padrão utilizando formatos de bloco de edição seguros.
• Edição Avançada de Código: Alterações de texto cirúrgicas, suporte a múltiplos arquivos, correspondência de padrões e integração com ripgrep para uma exploração profunda do código-fonte.
• Manipulação de Imagens e URLs: read_file pode visualizar e analisar tanto arquivos locais quanto recursos da web remotos, suportando dados de texto e imagem.
• Controles de Segurança: Defina diretórios permitidos, bloqueie comandos arriscados e revise telemetria (opção de saída suportada).
• Multiplataforma: Funciona totalmente no macOS, Windows e Linux, com correções automáticas específicas para o ambiente.

Casos de Uso

• Explorar, pesquisar e entender grandes ou complexos bases de código em minutos
• Refatoração ou correção cirúrgica de código preciso em múltiplos arquivos/projetos
• Gerar documentação ou diagramas através da extração e processamento de código/texto
• Automatizar tarefas repetitivas ou de desenvolvedor entre projetos a partir de uma única interface de chat
• Realizar scripting de sistema, configuração de ambiente e gerenciamento de processos via IA
• Depurar rapidamente, executar em teste ou terminar processos, builds e execuções de servidor
• Trabalhar em múltiplos ambientes de sistema operacional sem custo de API por token

FAQ

1. O que é o Desktop Commander MCP? É um servidor MCP que capacita o Claude Desktop a interagir completamente com seu sistema de arquivos e OS, permitindo tarefas como exploração de código-fonte, edição precisa de código, automação e controle de terminal/processo através de linguagem natural.

2. Como isso difere de ferramentas como Cursor ou Windsurf? O Desktop Commander MCP oferece controle amplo em nível de OS além de qualquer IDE, suporta fluxos de trabalho multi-projeto e multi-diretório, fornece acesso completo a arquivos (não apenas pedaços) e aproveita o plano Pro do Claude Desktop sem custos adicionais de API por token.

3. O Desktop Commander requer créditos de API ou pagamento extra? Não — uma vez que você tenha o Claude Desktop Pro, todas as operações ocorrem localmente sem encargos extras ou taxas por token.

4. Como atualizo o Desktop Commander? Se instalado via npx ou Smithery, o Desktop Commander se atualiza automaticamente ao reiniciar o Claude Desktop. Para instalações manuais, basta reexecutar o comando de configuração.

5. Os dados de telemetria são coletados? A telemetria é mínima e não pessoal por padrão. Você pode optar por não participar a qualquer momento pedindo ao Claude: "desativar telemetria".