Quais são as desvantagens de Filesystem (reference server)?

Descrito pelo projeto MCP como referência, não pronto para produção; as sobrescritas não são atômicas em caso de falha; a 2.0.0 exige Node.js 24 ou posterior; redundante em agentes de código com ferramentas de arquivos embutidas.

Quanto custa Filesystem (reference server) para uma equipe ou em produção?

Gratuito e com licença MIT. O custo de operação é o contexto: 13 definições de ferramentas em cada requisição, mais resultados de directory_tree e read_multiple_files que podem encher uma janela de contexto rapidamente em pastas grandes.

Filesystem (reference server) é seguro para dados da empresa?

Lê e grava qualquer coisa nos diretórios permitidos com as permissões do seu usuário; nada sai da máquina além do que o cliente envia ao modelo. Montagens Docker ro deixam uma pasta somente leitura. Dois avisos de alta gravidade de fuga do sandbox, CVE-2025-53109 e CVE-2025-53110, foram corrigidos em julho de 2025.

Quais são as melhores alternativas ao Filesystem (reference server)?

As alternativas mais próximas que analisamos são Git (reference server) e Memory (reference server).

Filesystem (reference server) análise do servidor MCP (2026)

O que é Filesystem (reference server)?

O Filesystem é um dos sete servidores de referência ainda mantidos pelo grupo diretor do MCP no repositório principal modelcontextprotocol/servers; ao contrário de GitHub, Postgres ou Slack, ele não foi transferido para o arquivo. Ele dá a um assistente de IA 13 ferramentas para ler e gravar arquivos, editá-los com saída em diff, criar e listar diretórios, mover arquivos, buscar por padrão e ler metadados de arquivos. A versão 2.0.0, lançada em 19 de outubro de 2026, suporta tanto o protocolo 2026-07-28 quanto clientes da era 2025, e exige Node.js 24 ou posterior.

O acesso é limitado aos diretórios permitidos, passados na linha de comando (npx -y @modelcontextprotocol/server-filesystem /path/to/dir). Clientes mais antigos com suporte a MCP Roots ainda podem substituí-los em tempo de execução, mas o Roots está obsoleto na especificação 2026-07-28. O pacote npm teve cerca de 440.000 downloads na semana até 18 de outubro de 2026.

Como instalar Filesystem (reference server)

npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Filesystem (reference server) vale a pena?

O servidor de referência Filesystem está vivo e mantido no repositório principal modelcontextprotocol/servers, e recebeu uma atualização substancial em 19 de outubro de 2026. A versão 2.0.0 fala tanto o novo protocolo 2026-07-28 quanto o handshake antigo de 2025, e elevou a versão mínima do Node.js para 24, o que vai quebrar configurações em máquinas mais antigas. Cerca de 440.000 downloads semanais no npm mostram quantas configurações ainda dependem dele.

Treze ferramentas cobrem o que falta a um app de chat: read_text_file com head e tail, read_media_file, read_multiple_files, write_file, edit_file com diff no estilo git e prévia dryRun, listagens e árvores de diretórios, search_files, move_file, get_file_info e list_allowed_directories. Cada chamada é verificada contra os diretórios permitidos, e cada ferramenta traz dicas de somente leitura, idempotente e destrutiva para que um cliente possa perguntar antes de gravar. Não há ferramenta de exclusão, uma omissão sensata.

O modelo de acesso mudou com o novo protocolo. O MCP Roots, que permitia a um cliente trocar as pastas permitidas em tempo de execução, está obsoleto na especificação 2026-07-28, então, para um cliente moderno, os diretórios da linha de comando são a lista de permissões inteira. A linha 2.0 também endureceu o tratamento de roots: uma atualização sem roots válidos agora revoga o acesso em vez de recorrer a um padrão. O histórico recomenda manter-se atualizado. Em julho de 2025, dois avisos de alta gravidade, CVE-2025-53109 e CVE-2025-53110, mostraram que symlinks e prefixos de caminho parecidos podiam escapar do sandbox; foram corrigidos na 0.6.3 e na 2025.7.1.

O projeto MCP diz com clareza que esses servidores são exemplos educacionais, não produtos de produção. write_file sobrescreve no lugar e não é atômico em caso de falha, e apontar o servidor para um diretório home entrega ao modelo cada dotfile e chave que estiver nele. A imagem Docker com bind mounts somente leitura, documentada no README, é o padrão mais seguro. Claude Code, Cursor e Codex têm ferramentas de arquivos próprias e melhores, então o lugar real do servidor é o Claude Desktop e agentes personalizados construídos sobre um SDK.

Onde ele se destaca

Uma gerente de operações que usa o Claude Desktop em um notebook de trabalho
Deixar o assistente ler e organizar uma pasta de atas de reunião e relatórios
Adicione a configuração npx com um diretório permitido, como ~/Documents/ops. O modelo pode resumir, renomear com move_file e reescrever arquivos; não há ferramenta de exclusão, mas write_file sobrescreve, então mantenha a pasta em um local sincronizado ou com backup.
Um desenvolvedor construindo um agente de processamento de documentos sobre um SDK MCP
Dar ao agente acesso a arquivos em sandbox sem escrever ferramentas de arquivos
Rode a imagem Docker mcp/filesystem com o workspace montado em /projects e os dados de referência montados como somente leitura. Treze ferramentas anotadas poupam o trabalho de escrever e proteger as suas próprias; não custa nada, mas o projeto não oferece suporte para produção.
Um engenheiro de segurança aprovando servidores MCP para 50 desktops
Decidir se o servidor filesystem é seguro para liberar
Exija a 2.0.0 ou posterior (versões anteriores à 0.6.3 e à 2025.7.1 têm os CVEs de fuga do sandbox), permita apenas pastas de projeto e nunca o diretório home, e prefira montagens Docker somente leitura onde os usuários só precisam ler.

Antes de decidir

Configuração: npx -y @modelcontextprotocol/server-filesystem /path/to/dir na configuração do Claude Desktop, botões de instalação com um clique para o VS Code ou a imagem Docker mcp/filesystem. Exige Node.js 24 ou posterior para o npx; as ferramentas ficam disponíveis assim que o cliente reinicia.
Integrações: 13 ferramentas: nove somente leitura (read_text_file, read_media_file, read_multiple_files, list_directory, list_directory_with_sizes, directory_tree, search_files, get_file_info, list_allowed_directories) e quatro que gravam (create_directory, write_file, edit_file, move_file). Apenas local; todas as ferramentas definem openWorldHint como false.
Dados e privacidade: Lê e grava qualquer coisa nos diretórios permitidos com as permissões do seu usuário; nada sai da máquina além do que o cliente envia ao modelo. Montagens Docker ro deixam uma pasta somente leitura. Dois avisos de alta gravidade de fuga do sandbox, CVE-2025-53109 e CVE-2025-53110, foram corrigidos em julho de 2025.
Custo em escala: Gratuito e com licença MIT. O custo de operação é o contexto: 13 definições de ferramentas em cada requisição, mais resultados de directory_tree e read_multiple_files que podem encher uma janela de contexto rapidamente em pastas grandes.
Limites: As gravações não são atômicas em caso de falha, move_file falha se o destino existir, e não há ferramenta de exclusão. Em clientes 2026-07-28, o Roots não pode alterar a lista de permissões, e um servidor iniciado sem diretórios responde a toda chamada com erro.

O que é bom

Verificação de diretórios permitidos em cada chamada
Dicas nas ferramentas separam operações somente leitura das destrutivas
edit_file mostra um diff e permite simulação
Mantido pelo projeto MCP; 2.0.0 lançada em 19 de outubro de 2026

O que não é

Descrito pelo projeto MCP como referência, não pronto para produção
As sobrescritas não são atômicas em caso de falha
A 2.0.0 exige Node.js 24 ou posterior
Redundante em agentes de código com ferramentas de arquivos embutidas

Ideal para

Usuários do Claude Desktop ou de agentes personalizados que precisam de acesso controlado a uma ou duas pastas locais.

Alternativas ao Filesystem (reference server)

Git (reference server)

Model Context ProtocolVersion control

3.8/5

Official MCP reference server that gives a model 12 Git tools (status, diff, commit, branch, log) on a local repository.

Memory (reference server)

Model Context ProtocolMemory & reasoning

3.5/5

Official MCP reference server that gives a model persistent memory as a local knowledge graph of entities and relations.

Filesystem (reference server): perguntas frequentes

Filesystem (reference server) vale a pena?: Ainda a forma mais limpa de entregar a um app de chat uma pasta e nada mais, desde que você lembre que o próprio projeto MCP o chama de exemplo didático. Damos nota 4.1 de 5.
Quanto custa Filesystem (reference server)?: Gratuito e de código aberto.
Quais são as desvantagens de Filesystem (reference server)?: Descrito pelo projeto MCP como referência, não pronto para produção; as sobrescritas não são atômicas em caso de falha; a 2.0.0 exige Node.js 24 ou posterior; redundante em agentes de código com ferramentas de arquivos embutidas.
Para quem Filesystem (reference server) é indicado?: Usuários do Claude Desktop ou de agentes personalizados que precisam de acesso controlado a uma ou duas pastas locais.
Quanto custa Filesystem (reference server) para uma equipe ou em produção?: Gratuito e com licença MIT. O custo de operação é o contexto: 13 definições de ferramentas em cada requisição, mais resultados de directory_tree e read_multiple_files que podem encher uma janela de contexto rapidamente em pastas grandes.
Filesystem (reference server) é seguro para dados da empresa?: Lê e grava qualquer coisa nos diretórios permitidos com as permissões do seu usuário; nada sai da máquina além do que o cliente envia ao modelo. Montagens Docker ro deixam uma pasta somente leitura. Dois avisos de alta gravidade de fuga do sandbox, CVE-2025-53109 e CVE-2025-53110, foram corrigidos em julho de 2025.
Quais são as melhores alternativas ao Filesystem (reference server)?: As alternativas mais próximas que analisamos são Git (reference server) e Memory (reference server).

Respostas verificadas em 22 de out. de 2026.