Filesystem MCP Server

Servidor MCP de Sistema de Arquivos

Servidor Ruby que implementa o Protocolo de Contexto de Modelo (MCP) para operações de sistema de arquivos usando a gem vector_mcp.

Recursos

• Operações de arquivo: ler, escrever, editar, mover
• Operações de diretório: criar, listar
• Busca avançada com filtragem e ordenação
• Operações de metadados em lote
• Autenticação e autorização opcionais
• Limites seguros do sistema de arquivos usando raízes MCP

Instalação

1. Instale Ruby 3.1+ e bundler
2. Clone este repositório
3. Execute bundle install

Uso

Modo Básico

ruby file_system_mcp.rb ~/Documents ~/Desktop

Modo Seguro (com autenticação)

FILESYSTEM_MCP_API_KEY=your-secret-key ruby file_system_mcp.rb --enable-auth ~/Documents

Configuração do Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "ruby",
      "args": [
        "/path/to/file_system_mcp.rb",
        "~/Documents",
        "~/Desktop"
      ]
    }
  }
}

Para o modo seguro:

{
  "mcpServers": {
    "filesystem": {
      "command": "ruby",
      "args": [
        "/path/to/file_system_mcp.rb",
        "--enable-auth",
        "~/Documents"
      ],
      "env": {
        "FILESYSTEM_MCP_API_KEY": "your-secret-key"
      }
    }
  }
}

Ferramentas

Operações de Arquivo

• read_file - Lê o conteúdo completo do arquivo
• read_multiple_files - Lê vários arquivos de uma vez
• write_file - Cria/sobrescreve arquivos
• edit_file - Faz substituições precisas de texto com pré-visualização de diff
• move_file - Move/renomeia arquivos e diretórios

Operações de Diretório

• list_directory - Lista conteúdos com metadados opcionais
• create_directory - Cria diretórios recursivamente

Operações de Busca

• search_files - Busca recursiva básica com padrões
• find_files - Busca avançada com ordenação, filtragem e metadados

Operações de Informação

• get_file_info - Obtém metadados detalhados de arquivo/diretório
• get_bulk_file_info - Obtém metadados de vários arquivos de forma eficiente

Segurança

O servidor impõe limites do sistema de arquivos usando raízes MCP - ele só pode acessar diretórios especificados como argumentos de linha de comando.

A autenticação opcional adiciona verificação de chave de API para todas as operações.

Requisitos

• Ruby 3.1+
• gem vector_mcp v0.3.1+