Detalhes do Projeto Desktop Commander MCP

Visão Geral do Projeto

Desktop Commander MCP é uma ferramenta de servidor baseada no Protocolo de Contexto de Modelo (MCP), projetada especificamente para o aplicativo Claude Desktop. Ele capacita o Claude com controle de terminal, pesquisa no sistema de arquivos e edição diferenciada de arquivos através do protocolo MCP, transformando o Claude em um poderoso assistente de desenvolvimento.

Este projeto expande a funcionalidade do servidor de sistema de arquivos MCP, permitindo que os desenvolvedores operem diretamente o sistema local através do Claude, executem comandos, gerenciem arquivos e realizem edição de código, superando as capacidades dos editores de IA tradicionais.

Principais Características e Funcionalidades

🖥️ Operações de Terminal

• Execução de Comandos: Executa comandos de terminal com suporte para streaming de saída
• Controle de Tempo Limite: Tempo limite de comando configurável e suporte para execução em segundo plano
• Gerenciamento de Processos: Lista e encerra processos em execução
• Gerenciamento de Sessões: Suporte para gerenciamento de sessões de longa duração
• Suporte Multi-Shell: Suporte para diferentes ambientes Shell como bash, zsh, powershell

📁 Operações do Sistema de Arquivos

• Leitura e Escrita de Arquivos: Funcionalidade completa de leitura e escrita de arquivos
• Gerenciamento de Diretórios: Criação, listagem, movimentação de arquivos e diretórios
• Pesquisa de Arquivos: Funcionalidade de pesquisa baseada em nomes de arquivos
• Obtenção de Metadados: Obtenção de informações detalhadas de arquivos e diretórios
• Suporte Multi-Arquivo: Leitura simultânea de múltiplos arquivos
• Leitura de Conteúdo de URL: Suporte para leitura de conteúdo de texto e imagem de URLs

✏️ Capacidades de Edição de Código

• Substituição Precisa: Substituição de texto cirúrgica para pequenas modificações
• Reescrita Completa: Reescrita completa de arquivos para grandes alterações
• Suporte Multi-Arquivo: Edição simultânea de múltiplos arquivos
• Substituição por Padrão: Substituição de texto baseada em padrões
• Pesquisa de Código: Utilização do vscode-ripgrep para pesquisa recursiva de código ou texto

⚙️ Gerenciamento de Configuração do Servidor

• Obtenção/Definição de Configuração: Obtenção e definição de valores de configuração
• Atualização em Lote: Atualização de múltiplas configurações de uma só vez
• Configuração Dinâmica: Alterações de configuração sem necessidade de reiniciar o servidor
• Controle de Segurança: Suporte para bloquear comandos específicos e restringir o acesso a diretórios

Métodos de Instalação

Método 1: Instalação Rápida com NPX (Recomendado)

npx @wonderwhy-er/desktop-commander@latest setup

Método 2: Instalação Automatizada no macOS

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Método 3: Instalação com Smithery

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

Método 4: Instalação Manual (Construção)

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

Principais Ferramentas Categorizadas

Ferramentas de Gerenciamento de Configuração

• get_config: Obter a configuração completa do servidor
• set_config_value: Definir um valor de configuração específico

Ferramentas de Terminal

• execute_command: Executar um comando de terminal
• read_output: Ler a nova saída de uma sessão em execução
• force_terminate: Forçar o término de uma sessão em execução
• list_sessions: Listar todas as sessões de terminal ativas
• list_processes: Listar todos os processos em execução
• kill_process: Encerrar um processo por PID

Ferramentas do Sistema de Arquivos

• read_file: Ler um arquivo local ou conteúdo de URL
• read_multiple_files: Ler múltiplos arquivos simultaneamente
• write_file: Substituir completamente o conteúdo de um arquivo
• create_directory: Criar um diretório
• list_directory: Obter uma lista detalhada de um diretório
• move_file: Mover ou renomear arquivos e diretórios
• search_files: Encontrar arquivos por nome
• search_code: Pesquisar padrões de texto/código no conteúdo de arquivos
• get_file_info: Obter metadados detalhados de um arquivo ou diretório

Ferramentas de Edição de Texto

• edit_block: Aplicar substituições de texto cirúrgicas

Vantagens Técnicas

Comparação com Ferramentas IDE Tradicionais

• Solução para Todo o Sistema: Opera em todo o sistema operacional, não apenas no ambiente IDE
• Leitura Completa de Arquivos: Claude pode ler arquivos completos, em vez de processar em partes
• Suporte Multi-Projeto: Pode lidar com múltiplos projetos simultaneamente
• Execução Única: Pode executar alterações de uma só vez, reduzindo a necessidade de confirmações repetidas

Custo-Benefício

• Baseado na assinatura Pro padrão do Claude Desktop ($20/mês)
• Sem custos adicionais de chamadas de API
• Mecanismo de atualização automática, obtendo a versão mais recente automaticamente ao instalar via NPX ou Smithery

Casos de Uso

Cenários de Desenvolvimento

• Exploração e compreensão de bases de código complexas
• Geração de gráficos e documentação
• Automação de tarefas entre sistemas
• Trabalho simultâneo em múltiplos projetos
• Modificações precisas de código

Características de Segurança

• Lista configurável de comandos bloqueados
• Controle de acesso a diretórios permitido
• Gerenciamento e monitoramento de processos
• Persistência e validação de configuração