Filesystem MCP Server

Filesystem MCP Server

Um servidor de Model Context Protocol (MCP) que fornece operações de sistema de arquivos para o Claude AI.

Recursos

Este servidor MCP fornece as seguintes operações de sistema de arquivos:

1. read_file: Ler o conteúdo completo de um arquivo

   • Entrada: path (string)
   • Lê o conteúdo completo do arquivo com codificação UTF-8

2. read_multiple_files: Ler vários arquivos simultaneamente

   • Entrada: paths (string[])
   • Falhas na leitura não interrompem a operação inteira

3. write_file: Criar um novo arquivo ou sobrescrever um existente

   • Entradas:
     • path (string): Local do arquivo
     • content (string): Conteúdo do arquivo

4. create_directory: Criar um novo diretório ou garantir que ele exista

   • Entrada: path (string)
   • Cria diretórios pai se necessário
   • Conclui silenciosamente se o diretório já existir

5. list_directory: Listar o conteúdo do diretório com prefixos [FILE] ou [DIR]

   • Entrada: path (string)

6. move_file: Mover ou renomear arquivos e diretórios

   • Entradas:
     • source (string)
     • destination (string)
   • Falha se o destino já existir

7. search_files: Pesquisar recursivamente por arquivos/diretórios

   • Entradas:
     • path (string): Diretório inicial
     • pattern (string): Padrão de pesquisa
   • Correspondência sem diferenciar maiúsculas de minúsculas
   • Retorna caminhos completos para as correspondências

8. get_file_info: Obter metadados detalhados de arquivo/diretório

   • Entrada: path (string)
   • Retorna:
     • Tamanho
     • Horário de criação
     • Horário de modificação
     • Horário de acesso
     • Tipo (arquivo/diretório)
     • Permissões

9. list_allowed_directories: Listar todos os diretórios que o servidor tem permissão de acessar

   • Nenhuma entrada necessária
   • Retorna os diretórios dos quais este servidor pode ler/gravar

Segurança

O servidor só permite operações dentro de diretórios especificados por argumentos de linha de comando.

Instalação

1. Clone este repositório
2. Instale as dependências: npm install
3. Compile o projeto: npm run build

Uso

Execute o servidor com um ou mais diretórios permitidos:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

Configuração do MCP

Adicione o servidor ao seu arquivo de configuração do MCP:

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Licença

ISC