Readonly Filesystem MCP Server

Servidor MCP de Sistema de Archivos de Solo Lectura

Servidor Node.js que implementa el Protocolo de Contexto de Modelo (MCP) para operaciones de sistema de archivos de solo lectura. Un clon de modelcontextprotocol/server-filesystem.

Características

• Leer archivos
• Listar directorios
• Buscar archivos
• Obtener metadatos de archivos

Nota: El servidor solo permitirá operaciones dentro de los directorios especificados mediante args.

API

Recursos

• file://system: Interfaz de operaciones del sistema de archivos

Herramientas

• read_file

  • Lee el contenido completo de un archivo
  • Entradas:
    • path (cadena): Ruta del archivo a leer
    • from (número): Opcional. Número de línea inicial para la lectura. El valor predeterminado es 0.
    • to (número): Opcional. Número de línea final. Si no se establece, lee hasta el final del archivo.
  • Lee el contenido del archivo (completo o parcial) con codificación UTF-8

• read_multiple_files

  • Lee múltiples archivos simultáneamente
  • Entrada: paths (cadena[])
  • Las lecturas fallidas no detendrán toda la operación

• list_directory

  • Lista el contenido del directorio con prefijos [FILE] o [DIR]
  • Entrada: path (cadena)

• search_files

  • Busca archivos/directorios de forma recursiva
  • Entradas:
    • path (cadena): Directorio inicial
    • pattern (cadena): Patrón de búsqueda
    • excludePatterns (cadena[]): Excluir cualquier patrón. Se admiten formatos glob.
  • Coincidencia sin distinción de mayúsculas y minúsculas
  • Devuelve rutas completas a las coincidencias

• get_file_info

  • Obtiene metadatos detallados de archivos/directorios
  • Entrada: path (cadena)
  • Devuelve:
    • Tamaño
    • Hora de creación
    • Hora de modificación
    • Hora de acceso
    • Tipo (archivo/directorio)
    • Permisos

• list_allowed_directories

  • Lista todos los directorios a los que el servidor tiene permitido acceder
  • No requiere entrada
  • Devuelve:
    • Directorios desde los que este servidor puede leer/escribir

Uso con Claude Desktop

Agrega esto a tu claude_desktop_config.json:

Nota: puedes proporcionar directorios en sandbox al servidor montándolos en /projects. Agregar el indicador ro hará que el directorio sea de solo lectura para el servidor.

NPX

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

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.