Cómo funciona el servidor Filesystem MCP de referencia: sus 13 herramientas, las carpetas permitidas, Roots, los montajes Docker de solo lectura y un generador que escribe el JSON de configuración por ti.
El servidor Filesystem MCP es el programa Node.js de referencia del proyecto Model Context Protocol que permite a un asistente de IA leer, escribir, buscar y mover archivos, pero solo dentro de las carpetas que autorices. Indicas esas carpetas al iniciarlo, o tu aplicación las proporciona mediante Roots. Todo lo que queda fuera se rechaza.
El servidor Filesystem MCP de un vistazo
Elemento
Valor
Paquete npm
@modelcontextprotocol/server-filesystem
Imagen Docker
mcp/filesystem
Dónde se ejecuta
En tu propio ordenador, iniciado por tu aplicación MCP
Límite de acceso
Solo carpetas permitidas, por argumentos o Roots
Herramientas
13, de las cuales 9 solo leen
MCP (Model Context Protocol) es un estándar abierto que permite a una aplicación de asistente llamar a pequeños programas auxiliares llamados servidores. El servidor de archivos es el que casi todo el mundo instala primero, porque convierte "mira mi carpeta de descripciones de productos" en algo que el asistente puede hacer de verdad. Esta página explica a qué puede acceder, cómo funciona el límite de carpetas y cómo mantenerlo en solo lectura. Usa el generador de abajo para crear una configuración que puedas pegar en los ajustes MCP de tu aplicación.
Escribe las carpetas que quieres que vea el asistente, una por línea, con rutas completas.
Elige npx (necesita Node.js) o Docker. Docker puede montar carpetas en solo lectura.
Elige el formato de configuración que espera tu aplicación: la mayoría usa mcpServers, VS Code usa servers.
Copia el JSON en el archivo de configuración MCP de tu aplicación y reiníciala para que arranque el servidor.
Comparte la carpeta más pequeña que sirva, como una carpeta de contenido, nunca todo tu directorio personal.
Ejecútalo con Docker y montajes de solo lectura cuando el asistente solo necesite leer.
Pide al asistente que ejecute list_allowed_directories primero para ver exactamente a qué tiene acceso.
Usa la opción de prueba (dry run) de edit_file antes de dejar que los cambios lleguen a archivos que te importan.
Guarda una copia de seguridad o un historial de versiones de todo lo que dejes escribir al asistente.
Preguntas frecuentes
¿Puede el servidor Filesystem MCP leer archivos fuera de las carpetas que indico?
No. El README indica que todas las operaciones de archivos están restringidas a las carpetas permitidas. Si el cliente envía Roots, estas sustituyen por completo a las carpetas de la línea de comandos, así que la lista permitida es la última que proporcionó tu aplicación.
¿Qué pasa si lo inicio sin ninguna carpeta?
Si tu aplicación admite Roots, el servidor espera a que la aplicación las envíe. Si la aplicación no admite Roots y no diste ninguna carpeta, el servidor registra el motivo, cierra la conexión y termina con el estado 1.
¿Cómo lo dejo en solo lectura?
El README documenta una forma: ejecutar la imagen Docker y añadir ro a cada montaje, lo que deja esa carpeta en solo lectura para el servidor. Algunas aplicaciones también permiten aprobar o bloquear herramientas concretas, lo que ayuda, pero el montaje es el límite más firme.
¿Puede borrar archivos?
Su lista de herramientas no incluye ninguna de borrado. Aun así puede destruir contenido: write_file sobrescribe archivos existentes y move_file elimina el origen, por eso ambas aparecen como destructivas en la tabla de anotaciones del README.
¿Necesita acceso a internet?
No para su trabajo. Todas las herramientas fijan openWorldHint en false, es decir, solo tocan el sistema de archivos local dentro de las carpetas permitidas. npx sí descarga el paquete la primera vez que se ejecuta.
Carpetas permitidas y Roots, en palabras sencillas
Hay dos formas de decirle al servidor qué carpetas puede usar. La primera es poner las rutas de las carpetas después del nombre del paquete en la configuración, lo que fija la lista hasta que reinicies. La segunda es Roots, una función con la que la aplicación del asistente indica al servidor qué carpetas están en juego y puede cambiar esa lista mientras se ejecuta.
El README considera Roots el método recomendado. El detalle que importa para la seguridad: una vez que las Roots de tu aplicación están activas, una actualización sin raíces válidas revoca todo el acceso en lugar de volver a las carpetas que escribiste.
Tareas útiles para quien tiene un sitio o una tienda
Apúntalo a una carpeta con datos de productos exportados y pide una lista de artículos sin descripción. Apúntalo a tus borradores del blog y pide un resumen de qué entradas mencionan un precio antiguo. Apúntalo a una copia descargada de tu sitio y busca nombres de imágenes rotos.
En todos los casos la carpeta es una copia, no el sitio en vivo, así que una edición equivocada no cuesta nada. Ese hábito vale más que cualquier ajuste.
Las 13 herramientas y qué puede cambiar cada una
Solo lectura significa que el README marca la herramienta con readOnlyHint true. Destructiva significa que puede sobrescribir o eliminar contenido existente.
Herramientas del servidor Filesystem MCP
Herramienta
Qué hace
¿Cambia archivos?
Lee un archivo como texto UTF-8, opcionalmente solo las primeras o últimas N líneas
No
Lee una imagen, un audio u otro archivo como base64 con su tipo MIME
No
Lee varios archivos a la vez; un fallo no detiene el resto
No
Lista una carpeta con los prefijos [FILE] y [DIR]
No
El mismo listado con tamaños, ordenable por nombre o tamaño
No
Devuelve un árbol JSON anidado de una carpeta
No
Búsqueda tipo glob con patrones de exclusión opcionales
No
Tamaño, fechas, tipo y permisos
No
Muestra qué carpetas puede usar el servidor
No
Crea una carpeta y las carpetas padre que falten
Sí, no destructiva
Crea o sobrescribe un archivo
Sí, destructiva
Sustituye el texto que coincide, con una opción de vista previa dryRun
Sí, destructiva
Mueve o renombra; falla si el destino ya existe
Sí, destructiva
Ejemplos de configuración
Ejecutar con npx, dos carpetas
Las carpetas después del nombre del paquete pasan a ser las carpetas permitidas. Necesita Node.js en tu equipo.
Ejecutar con Docker, una carpeta en solo lectura
Las carpetas se montan bajo /projects. La marca ro impide que el servidor escriba en esa carpeta.
Configuración del espacio de trabajo de VS Code (.vscode/mcp.json)
VS Code usa la clave servers. ${workspaceFolder} limita el servidor al proyecto que tienes abierto.
Generador de configuración de Filesystem MCP
Escribe tus carpetas y elige cómo ejecutar el servidor. El JSON se actualiza mientras escribes y nada sale de tu navegador.
Carpetas permitidas, una ruta completa por línea
Ejecutar con
Formato de configuración
Montar carpetas en solo lectura (solo Docker)
El montaje de solo lectura está documentado para Docker. Con npx el servidor puede escribir dentro de las carpetas que indiques.
JSON de configuración
npx (Node.js)
Docker
mcpServers (la mayoría de aplicaciones)
servers (VS Code)
Añade al menos una carpeta. El servidor necesita una carpeta permitida para funcionar.
{v} no es una ruta completa. Empiézala con / en Mac o Linux, o con una letra de unidad en Windows.