Sobre o projeto

O Desktop Commander MCP é um servidor do Protocolo de Contexto do Modelo (MCP) que estende assistentes de IA — principalmente o Claude Desktop — com poderosas capacidades de controle de terminal, operações de sistema de arquivos e edição de código. Construído sobre o servidor de sistema de arquivos MCP, ele fornece uma caixa de ferramentas abrangente para desenvolvimento e automação orientados por IA. As principais capacidades incluem: Gerenciamento de Terminal e Processos: Executar comandos de terminal com streaming de saída, gerenciar processos em execução (listar, interagir, terminar), lidar com comandos de longa duração através de gerenciamento de sessões e suportar timeouts de comando e execução em segundo plano. A ferramenta inclui paginação de saída de processo para evitar transbordamento de contexto. Operações de Sistema de Arquivos: Acesso completo ao sistema de arquivos, incluindo leitura e gravação de arquivos (texto, Excel, PDF, DOCX), criação e listagem de diretórios com profundidade configurável, movimentação de arquivos, busca de arquivos e conteúdo (incluindo conteúdo do Excel) e recuperação de metadados de arquivos. Suporta leitura de arquivos com offset negativo (como o tail do Unix) e listagem recursiva de diretórios com proteção contra transbordamento de contexto. Edição de Código: Substituições cirúrgicas de texto para pequenas alterações, reescritas completas de arquivos para grandes mudanças, suporte a múltiplos arquivos e substituições baseadas em padrões usando vscode-ripgrep para busca de código recursiva. Suporte Multi-formato: Suporte nativo para arquivos Excel (.xlsx, .xls, .xlsm) com capacidades de leitura, gravação, edição e pesquisa; suporte a PDF com extração de texto, criação a partir de markdown e modificação; suporte a DOCX com edição cirúrgica de XML e conversão de markdown para DOCX. Execução de Código: Executar código na memória (Python, Node.js, R) sem salvar arquivos, permitindo análise instantânea de dados de arquivos CSV, JSON e Excel. Segurança e Configuração: Inclui barreiras de segurança como prevenção de travessia de symlinks, listas de bloqueio de comandos e isolamento opcional via Docker para sandboxing completo. O gerenciamento de configuração do servidor permite alterações dinâmicas sem reinicialização, incluindo comandos bloqueados, shell padrão, diretórios permitidos e limites de linhas de leitura/gravação de arquivos. Flexibilidade de Instalação: Múltiplos métodos de instalação, incluindo npx (atualizações automáticas), instalador bash, Smithery, configuração manual, checkout local e instalação Docker (sem necessidade de Node.js). Funciona com Claude Desktop, Cursor, Windsurf, VS Code/GitHub Copilot, Cline, Roo Code, Claude Code, Trae, Kiro, Codex, JetBrains AI Assistant, Gemini CLI, Augment Code, Qwen Code, entre outros. MCP Remoto: Suporta acesso remoto do ChatGPT, Claude web e outros serviços de IA através de um Dispositivo Remoto leve que se conecta seguramente a um serviço em nuvem, permitindo que os comandos sejam executados localmente enquanto mantém o controle do usuário. Interface de Visualização de Arquivos: Visualizações visuais de arquivos no Claude Desktop com markdown renderizado, imagens inline, conteúdo expansível, editor de markdown integrado e acesso rápido "Abrir na pasta". Auditoria e Histórico: Histórico local de chamadas de ferramentas e logs de auditoria com rotação/trimming baseado em tamanho para manter os arquivos de histórico ativo limitados. A ferramenta também inclui onboarding inteligente para novos usuários, fornecendo tutoriais e exemplos amigáveis para iniciantes para tarefas comuns, como organizar downloads, analisar arquivos de dados, configurar CI/CD e explorar codebases.