Servidor MCP de sistema de archivos de solo lectura

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

Características

• Leer archivos

• Lista de directorios

• Buscar archivos

• Obtener metadatos de archivos

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

Related MCP server: Filesystem MCP Server

API

Recursos

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

Herramientas

• leer_archivo

  • Leer el contenido completo de un archivo

  • Entradas:

    • path (cadena): Ruta del archivo a leer

    • from (número): Opcional. Número de línea inicial de lectura. El valor predeterminado es 0.

    • to (número): Opcional. Número de línea final. Si no se establece, se lee hasta el final del archivo.

  • Lee el contenido del archivo (completo o parcial) con codificación UTF-8

• leer_múltiples_archivos

  • Leer varios archivos simultáneamente

  • Entrada: paths (cadena[])

  • Las lecturas fallidas no detendrán toda la operación

• directorio_de_lista

  • Listar el contenido del directorio con prefijos [FILE] o [DIR]

  • Entrada: path (cadena)

• archivos de búsqueda

  • Buscar archivos/directorios de forma recursiva

  • Entradas:

    • path (cadena): Directorio de inicio

    • pattern (cadena): Buscar patrón

    • excludePatterns (string[]): Excluye cualquier patrón. Se admiten formatos glob.

  • Coincidencia sin distinción entre mayúsculas y minúsculas

  • Devuelve rutas completas a las coincidencias

• obtener_información_del_archivo

  • Obtener metadatos detallados de archivos/directorios

  • Entrada: path (cadena)

  • Devoluciones:

    • Tamaño

    • Tiempo de creación

    • Hora modificada

    • Tiempo de acceso

    • Tipo (archivo/directorio)

    • Permisos

• lista_de_directorios_permitidos

  • Enumere todos los directorios a los que el servidor tiene permiso de acceder

  • No se requiere entrada

  • Devoluciones:

    • Directorios desde los que este servidor puede leer/escribir

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Nota: Puede proporcionar directorios aislados al servidor montándolos en /projects . Al agregar el indicador ro , el servidor podrá leer el directorio solo.

NPX

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

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.