Readonly Filesystem MCP Server

Readonly Filesystem MCP Server

Servidor Node.js que implementa o Model Context Protocol (MCP) para operações de filesystem somente leitura. Um clone de modelcontextprotocol/server-filesystem.

Recursos

• Ler arquivos
• Listar diretórios
• Pesquisar arquivos
• Obter metadados de arquivos

Nota: O servidor só permitirá operações dentro dos diretórios especificados via args.

API

Recursos

• file://system: Interface de operações do sistema de arquivos

Ferramentas

• read_file

  • Lê o conteúdo completo de um arquivo
  • Entradas:
    • path (string): Caminho do arquivo a ser lido
    • from (number): Opcional. Número da linha inicial para leitura. O padrão é 0.
    • to (number): Opcional. Número da linha final. Se não definido, lê até o final do arquivo.
  • Lê o conteúdo do arquivo (completo ou parcial) com codificação UTF-8

• read_multiple_files

  • Lê múltiplos arquivos simultaneamente
  • Entrada: paths (string[])
  • Falhas na leitura não interrompem a operação inteira

• list_directory

  • Lista o conteúdo do diretório com prefixos [FILE] ou [DIR]
  • Entrada: path (string)

• search_files

  • Pesquisa recursivamente por arquivos/diretórios
  • Entradas:
    • path (string): Diretório inicial
    • pattern (string): Padrão de pesquisa
    • excludePatterns (string[]): Excluir quaisquer padrões. Formatos glob são suportados.
  • Correspondência sem diferenciar maiúsculas de minúsculas
  • Retorna caminhos completos para as correspondências

• get_file_info

  • Obtém metadados detalhados de arquivo/diretório
  • Entrada: path (string)
  • Retorna:
    • Tamanho
    • Hora de criação
    • Hora de modificação
    • Hora de acesso
    • Tipo (arquivo/diretório)
    • Permissões

• list_allowed_directories

  • Lista todos os diretórios que o servidor tem permissão de acessar
  • Nenhuma entrada necessária
  • Retorna:
    • Diretórios de onde este servidor pode ler/gravar

Uso com Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

Observação: você pode fornecer diretórios em sandbox para o servidor montando-os em /projects. Adicionar a flag ro tornará o diretório somente leitura para o servidor.

NPX

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@danielsuguimoto/readonly-server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.