Filesystem MCP é um dos servidores de referência mantidos pela Anthropic no repositório oficial modelcontextprotocol/servers. Permite que clientes MCP (Claude Desktop, Claude Code, Cursor e outros) acedam a pastas específicas do disco do utilizador sem comprometer o restante sistema. A configuração declara explicitamente que diretórios estão acessíveis, o que limita o risco em cenários de uso agêntico. É um ponto de partida comum quando se experimenta MCP, porque muitos fluxos úteis começam por ler ou escrever ficheiros locais.

Funcionalidades

Leitura de ficheiros de texto, imagens e áudio

Escrita, edição com correspondência de padrões e sobrescrita de ficheiros

Criação e listagem de diretórios (com tamanhos opcionais)

Movimentação e renomeação de ficheiros e diretórios

Pesquisa recursiva por padrões de nome

Árvore recursiva do diretório em JSON

Consulta de metadados de ficheiros

Leitura de vários ficheiros em simultâneo

Diretórios permitidos configuráveis (limitam o alcance do agente)

Ferramentas disponíveis

read_text_file Lê o conteúdo completo de um ficheiro como texto.

read_media_file Lê um ficheiro de imagem ou áudio.

read_multiple_files Lê vários ficheiros em simultâneo.

write_file Cria um novo ficheiro ou sobrescreve um existente (usar com cuidado).

edit_file Edições seletivas com correspondência de padrões e formatação avançada.

create_directory Cria um novo diretório ou garante que já existe.

list_directory Lista o conteúdo de um diretório com prefixos [FILE] ou [DIR].

list_directory_with_sizes Lista o conteúdo de um diretório com prefixos [FILE] ou [DIR] e tamanhos dos ficheiros.

move_file Move ou renomeia ficheiros e diretórios.

search_files Pesquisa recursiva de ficheiros ou diretórios que correspondam (ou não) a padrões.

directory_tree Devolve a árvore recursiva do diretório em JSON.

get_file_info Obtém metadados detalhados de um ficheiro ou diretório.

list_allowed_directories Lista os diretórios a que o servidor tem acesso.