Servidor MCP Oficial

Filesystem MCP Server

Servidor MCP de referência para ler, escrever, pesquisar e mover arquivos dentro de diretórios que você permite explicitamente.

Autor: Model Context Protocol
Funciona com: Any MCP client
Licença: MIT
Documentado: Oct 2, 2026

Repositório ↗ Documentação oficial ↗

O que é Filesystem MCP Server

Servidor Node.js que implementa o MCP para operações de sistema de arquivos, publicado no npm como @modelcontextprotocol/server-filesystem. O acesso se limita aos diretórios permitidos, informados como argumentos de linha de comando ou via MCP Roots.

O que ela faz

Onde Filesystem MCP Server roda e o que acrescenta, segundo a documentação

Ler arquivos de texto (com opções head/tail) e arquivos de mídia
Ler vários arquivos de uma vez
Escrever e sobrescrever arquivos
Criar, listar e excluir diretórios e mover arquivos ou diretórios
Pesquisar arquivos e obter metadados
Atualizar os diretórios permitidos em tempo de execução via MCP Roots

Quando usar

Boa adequação

Deixar um agente trabalhar em algumas pastas específicas de projeto
Clientes com suporte a Roots que precisam alterar diretórios em tempo de execução

Não indicado para

Qualquer coisa que exija acesso fora dos diretórios permitidos
Uso em produção sem revisão própria: O README raiz diz que estas são implementações de referência, pensadas como exemplos educacionais, não soluções prontas para produção.

Como instalar o Filesystem MCP Server

Você precisa de: Node.js (npx); Ao menos um diretório permitido via argumentos ou Roots; caso contrário, dá erro ao iniciar

Certifique-se de que o Node.js e o npx estão disponíveis
Adicione o servidor à configuração do seu cliente MCP com o comando npx
Passe ao menos um diretório permitido como argumento, ou use um cliente com suporte a Roots
Reinicie o cliente e chame list_allowed_directories para confirmar

Exemplo de configuração (da documentação oficial)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/dir1",
        "/path/to/dir2"
      ]
    }
  }
}

Permissões e segurança

A que ela tem acesso

Lê e escreve arquivos e diretórios apenas dentro dos diretórios permitidos

Notas de segurança dos mantenedores

write_file sobrescreve arquivos existentes; o README pede cautela
O README raiz diz que estas são implementações de referência, pensadas como exemplos educacionais, não soluções prontas para produção.

Revise a fonte antes de conceder ao agente acesso a credenciais ou sistemas de produção. Documentamos o que os mantenedores informam; não auditamos o código.

Limitações

O servidor dá erro na inicialização se nenhum argumento for passado e o cliente não tiver suporte a Roots
Os Roots do cliente substituem completamente os diretórios da linha de comando

Perguntas frequentes

O que o servidor Filesystem MCP precisa para iniciar?

Ao menos um diretório permitido, passado como argumento ou fornecido pelo cliente via Roots. fonte

O servidor Filesystem MCP pode acessar arquivos fora dos diretórios permitidos?

Não. O README diz que todas as operações são restritas aos diretórios permitidos. fonte

Qual é o pacote npm do servidor Filesystem MCP?

@modelcontextprotocol/server-filesystem. fonte

Guias relacionados

Fontes e lacunas

https://raw.githubusercontent.com/modelcontextprotocol/servers/main/src/filesystem/README.md readme, verificado Oct 2, 2026
https://raw.githubusercontent.com/modelcontextprotocol/servers/main/README.md readme, verificado Oct 2, 2026

Não informado pelos mantenedores: Hosts além de clientes MCP genéricos não são citados individualmente como compatíveis com Claude Code/Cursor/Windsurf/Codex neste README; A data de last_release não aparece no README verificado.