Repolode
wonderwhy-er

wonderwhy-er/DesktopCommanderMCP

Servidor MCP que oferece ao Claude e a outros clientes de IA controle do terminal, busca de arquivos, edição baseada em diff e gerenciamento de documentos na máquina local.

Estrelas
10,105
Forks
1,290
Issues abertas
315
Último commit
há 17 horas

O que é?

O Desktop Commander é um servidor MCP (Model Context Protocol) que permite que clientes de IA, como Claude Desktop, Cursor, VS Code e Gemini CLI, executem comandos no terminal, gerenciem processos e trabalhem com arquivos no computador em que está rodando. Ele é baseado no MCP Filesystem Server e adiciona edição de arquivos por busca e substituição, para que um assistente possa fazer alterações pontuais no código em vez de reescrever arquivos inteiros.

Além de executar comandos no shell, ele pode iniciar programas interativos, como sessões de Python, Node.js ou SSH, e exibir a saída em páginas. Também lê e grava arquivos Excel, PDF e DOCX, e inclui um painel de visualização de arquivos com editor Markdown para o Claude Desktop. O histórico local de chamadas de ferramentas é gravado em disco, e o modo Remote Device permite que serviços de IA baseados na web enviem comandos para a máquina local enquanto ele está em execução.

O servidor oferece proteções configuráveis, como uma lista de bloqueio de comandos, diretórios permitidos e verificações de travessia de links simbólicos. A documentação de segurança do projeto esclarece que isso não funciona como um sandbox, e oferece a instalação com Docker para isolamento.

Recursos principais

  • 01Executar comandos no terminal e programas interativos, com paginação da saída e execução em segundo plano
  • 02Buscar arquivos e conteúdo, incluindo texto e dados do Excel
  • 03Fazer edições pontuais por busca e substituição, além de reescrever arquivos inteiros
  • 04Ler e gravar arquivos Excel, PDF e DOCX
  • 05Painel de visualização de arquivos com editor Markdown no Claude Desktop
  • 06Modo Remote Device para conectar serviços de IA baseados na web à máquina local

Casos de uso

  • Permitir que um assistente de IA refatore código em um projeto local com alterações pequenas e fáceis de revisar
  • Analisar arquivos CSV, JSON ou Excel com código Python executado em memória
  • Controlar sessões SSH ou servidores de desenvolvimento por meio de um chat com IA
  • Automatizar a organização de arquivos ou a conversão de documentos em um computador pessoal

Início rápido

  1. 1

    Execute o comando de configuração com o Node.js instalado

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

    Reinicie o Claude Desktop se ele estiver em execução

Antes de usar

  • Não é um ambiente isolado: ele pode executar comandos de terminal e acessar arquivos na sua máquina.
  • A opção 5 (checkout local) exige atualizações manuais do git.

Tópicos

Perguntas frequentes

O que é DesktopCommanderMCP?
Servidor MCP que oferece ao Claude e a outros clientes de IA controle do terminal, busca de arquivos, edição baseada em diff e gerenciamento de documentos na máquina local. O Desktop Commander é um servidor MCP (Model Context Protocol) que permite que clientes de IA, como Claude Desktop, Cursor, VS Code e Gemini CLI, executem comandos no terminal, gerenciem processos e trabalhem com arquivos no computador em que está rodando. Ele é baseado no MCP Filesystem Server e adiciona edição de arquivos por busca e substituição, para que um assistente possa fazer alterações pontuais no código em vez de reescrever arquivos inteiros.
DesktopCommanderMCP é gratuito? Qual é a licença?
DesktopCommanderMCP é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
DesktopCommanderMCP ainda é mantido?
Manutenção ativa. O último commit de DesktopCommanderMCP foi em 19 de out. de 2026.
Para que posso usar DesktopCommanderMCP?
Permitir que um assistente de IA refatore código em um projeto local com alterações pequenas e fáceis de revisar Analisar arquivos CSV, JSON ou Excel com código Python executado em memória Controlar sessões SSH ou servidores de desenvolvimento por meio de um chat com IA Automatizar a organização de arquivos ou a conversão de documentos em um computador pessoal
Como instalar DesktopCommanderMCP?
Execute o comando de configuração com o Node.js instalado: npx @wonderwhy-er/desktop-commander@latest setup Reinicie o Claude Desktop se ele estiver em execução
Onde consigo DesktopCommanderMCP?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wonderwhy-er/DesktopCommanderMCP

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados