Filesystem MCP Server

Filesystem MCP Server

Servidor Ruby que implementa el Model Context Protocol (MCP) para operaciones de sistema de archivos usando la gema vector_mcp.

Características

• Operaciones de archivo: leer, escribir, editar, mover
• Operaciones de directorio: crear, listar
• Búsqueda avanzada con filtrado y ordenación
• Operaciones de metadatos en lote
• Autenticación y autorización opcionales
• Límites seguros del sistema de archivos usando raíces MCP

Instalación

1. Instala Ruby 3.1+ y bundler
2. Clona este repositorio
3. Ejecuta bundle install

Uso

Modo básico

ruby file_system_mcp.rb ~/Documents ~/Desktop

Modo seguro (con autenticación)

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

Configuración de Claude Desktop

Añade a tu claude_desktop_config.json:

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

Para modo seguro:

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

Herramientas

Operaciones de archivo

• read_file - Lee el contenido completo del archivo
• read_multiple_files - Lee varios archivos a la vez
• write_file - Crea/sobrescribe archivos
• edit_file - Realiza reemplazos de texto precisos con vista previa de diferencias
• move_file - Mueve/renombra archivos y directorios

Operaciones de directorio

• list_directory - Lista contenidos con metadatos opcionales
• create_directory - Crea directorios recursivamente

Operaciones de búsqueda

• search_files - Búsqueda recursiva básica con patrones
• find_files - Búsqueda avanzada con ordenación, filtrado y metadatos

Operaciones de información

• get_file_info - Obtiene metadatos detallados de archivo/directorio
• get_bulk_file_info - Obtiene metadatos de varios archivos de manera eficiente

Seguridad

El servidor impone límites del sistema de archivos usando raíces MCP: solo puede acceder a directorios especificados como argumentos de línea de comandos.

La autenticación opcional añade verificación de clave API para todas las operaciones.

Requisitos

• Ruby 3.1+
• gema vector_mcp v0.3.1+