Fast Filesystem MCP

Um servidor de alto desempenho do Model Context Protocol (MCP) que fornece acesso seguro ao sistema de arquivos e ferramentas de desenvolvimento de código otimizadas por IA para o Claude e outros assistentes de IA.

GitHub

Experimente este MCPPatrocinado

Documentação

Operações avançadas de sistema de arquivos para Claude Desktop com capacidades de manipulação de arquivos grandes e recursos otimizados para Claude.

Início Rápido

Adicione à sua configuração do Claude Desktop.

Configuração básica

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}

Com arquivos de backup habilitados

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"],
      "env": {
        "CREATE_BACKUP_FILES": "true"
      }
    }
  }
}

Configuração de Backup

Controle o comportamento de criação de arquivos de backup.

CREATE_BACKUP_FILES=false (padrão): Desativa a criação de arquivos de backup para reduzir desordem
CREATE_BACKUP_FILES=true: Cria arquivos de backup antes de modificações

Nota: Os arquivos de backup são criados com carimbos de data/hora (ex.: file.txt.backup.1755485284402) para evitar perda de dados durante edições.

Configuração de Depuração e Registro

O servidor MCP usa um sistema de registro seguro que previne erros de comunicação JSON-RPC.

DEBUG_MCP=true ou MCP_DEBUG=true: Ativa registro de depuração em stderr
MCP_LOG_FILE=/path/to/log.txt: Grava registros em arquivo em vez de stderr
MCP_SILENT_ERRORS=true ou SILENT_ERRORS=true: Suprime mensagens de erro nas respostas

Nota: A saída de depuração é suprimida automaticamente por padrão para evitar erros de análise JSON no Claude Desktop.

Atualização para Nova Versão

Para atualizar para a versão mais recente, siga estes passos.

Desinstale a versão anterior
```
npm uninstall -g fast-filesystem-mcp
```

Limpe o cache e as dependências

npm cache clean --force
pnpm store prune

Instale a versão mais recente
```
npm install -g fast-filesystem-mcp
```

Verifique a instalação

npm list -g fast-filesystem-mcp
fast-filesystem-mcp --version

Recursos

Operações Principais de Arquivo

Leitura/Gravação Rápida de Arquivos: Otimizada para Claude Desktop com suporte a divisão em blocos
Leitura Sequencial: Leia arquivos grandes completamente com suporte a token de continuação
Manipulação de Arquivos Grandes: Gravação baseada em fluxo para arquivos de qualquer tamanho
Operações de Diretório: Listagem, criação e gerenciamento abrangentes de diretórios
Busca de Arquivos: Busca por nome e conteúdo com filtros

Capacidades Avançadas

Suporte a Paginação: Gerencie diretórios grandes com eficiência
Leitura em Blocos: Leia arquivos grandes em blocos gerenciáveis
Gravações em Fluxo: Gravação eficiente em memória para arquivos grandes
Backup e Recuperação: Criação automática de backup e recuperação de erros
Lógica de Repetição: Mecanismo de repetição integrado para operações confiáveis

Otimizações de Desempenho

Otimizado para Claude: Tamanhos e formatos de resposta otimizados para Claude
Eficiente em Memória: Operações em fluxo previnem estouro de memória
Exclusões Inteligentes: Exclui automaticamente arquivos e diretórios do sistema
Acompanhamento de Progresso: Monitoramento em tempo real para operações grandes

Ferramentas Disponíveis

Operações de Arquivo

Ferramenta	Descrição
`fast_read_file`	Leia arquivos com suporte a divisão em blocos
`fast_read_multiple_files`	Leia vários arquivos simultaneamente com suporte a leitura sequencial
`fast_write_file`	Grave ou modifique arquivos
`fast_large_write_file`	Gravação baseada em fluxo para arquivos grandes
`fast_get_file_info`	Obtenha informações detalhadas do arquivo

Gerenciamento Complexo de Arquivos

Ferramenta	Descrição
`fast_copy_file`	Copie arquivos e diretórios com opções avançadas
`fast_move_file`	Mova/renomeie arquivos e diretórios com segurança
`fast_delete_file`	Exclua arquivos e diretórios com proteção
`fast_batch_file_operations`	Execute múltiplas operações de arquivo em sequência

Gerenciamento de Arquivos Compactados

Ferramenta	Descrição
`fast_compress_files`	Crie arquivos compactados (tar, tar.gz, tar.bz2)
`fast_extract_archive`	Extraia arquivos compactados com opções

Sincronização de Diretórios

Ferramenta	Descrição
`fast_sync_directories`	Sincronização avançada de diretórios com múltiplos modos

Ferramentas Avançadas de Edição

Ferramenta	Descrição
`fast_edit_file`	Edição precisa de arquivos baseada em linhas com múltiplos modos
`fast_edit_block`	Edição segura de blocos com correspondência exata de strings
`fast_edit_blocks`	Edição em lote de blocos para múltiplas alterações precisas
`fast_edit_multiple_blocks`	Edite múltiplas seções em uma única operação
`fast_extract_lines`	Extraia linhas ou intervalos específicos de arquivos

Operações de Diretório

Ferramenta	Descrição
`fast_list_directory`	Liste o conteúdo do diretório com paginação
`fast_create_directory`	Crie diretórios recursivamente
`fast_get_directory_tree`	Obtenha a estrutura de árvore do diretório

Operações de Busca

Ferramenta	Descrição
`fast_search_files`	Busque arquivos por nome ou conteúdo
`fast_search_code`	Busca avançada de código com integração ripgrep
`fast_find_large_files`	Encontre arquivos grandes em diretórios

Operações de Sistema

Ferramenta	Descrição
`fast_get_disk_usage`	Verifique informações de uso do disco
`fast_list_allowed_directories`	Liste diretórios permitidos

Ferramentas de Edição

Edição Precisa de Arquivos

O fast-filesystem MCP agora inclui ferramentas poderosas de edição para código-fonte e arquivos de texto.

`fast_edit_file` - Edição de Bloco Único

Suporta múltiplos modos de edição.

replace: Substitua texto ou linhas inteiras
replace_range: Substitua múltiplas linhas de uma vez
insert_before: Insira conteúdo antes da linha especificada
insert_after: Insira conteúdo após a linha especificada
delete_line: Exclua linhas específicas

{
  "tool": "fast_edit_file",
  "arguments": {
    "path": "/path/to/file.js",
    "mode": "replace",
    "line_number": 10,
    "new_text": "const newVariable = 'updated value';",
    "backup": true
  }
}

`fast_edit_multiple_blocks` - Edição em Lote

Edite múltiplas partes de um arquivo em uma única operação.

{
  "tool": "fast_edit_multiple_blocks", 
  "arguments": {
    "path": "/path/to/file.js",
    "edits": [
      {
        "mode": "replace",
        "old_text": "oldFunction()",
        "new_text": "newFunction()"
      },
      {
        "mode": "insert_after",
        "line_number": 5,
        "new_text": "// Added comment"
      }
    ],
    "backup": true
  }
}

`fast_extract_lines` - Extração de Linhas

Extraia linhas específicas por número, intervalo ou padrão.

{
  "tool": "fast_extract_lines",
  "arguments": {
    "path": "/path/to/file.js",
    "pattern": "function.*",
    "context_lines": 2
  }
}

`fast_search_and_replace` - Substituição Avançada

Busca e substituição poderosa com suporte a regex.

{
  "tool": "fast_search_and_replace",
  "arguments": {
    "path": "/path/to/file.js", 
    "search_pattern": "console\\.log\\(.*\\)",
    "replace_text": "logger.info($1)",
    "use_regex": true,
    "max_replacements": 10,
    "backup": true
  }
}

Recursos de Edição

Backup Automático: Cria backups antes de modificações
Recuperação de Erros: Restaura a partir do backup em caso de falha
Operações Baseadas em Linhas: Controle preciso sobre linhas específicas
Correspondência de Padrões: Suporte a expressões regulares
Operações em Lote: Múltiplas edições em transação única
Extração de Contexto: Extraia linhas com contexto ao redor

Gravação de Arquivos Grandes

fast_large_write_file
- Fluxo: Grava arquivos em blocos para evitar problemas de memória
- Backup: Cria backups automaticamente antes de sobrescrever
- Verificação: Verifica a integridade do arquivo após a gravação
- Lógica de Repetição: Repetição automática em caso de falha com backoff exponencial
- Acompanhamento de Progresso: Monitoramento em tempo real do progresso de gravação

Licença

Apache 2.0

Licenciado sob a Licença Apache, Versão 2.0 (a "Licença"); você não pode usar este arquivo exceto em conformidade com a Licença. Você pode obter uma cópia da Licença em

Salvo disposição em contrário da lei aplicável ou acordo por escrito, o software distribuído sob a Licença é distribuído "COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, expressas ou implícitas. Consulte a Licença para obter as permissões específicas e limitações sob a Licença.

Repositório

https://github.com/efforthye/fast-filesystem-mcp