Servidor MCP Oficial

Filesystem MCP Server

Servidor MCP de referencia para leer, escribir, buscar y mover archivos en directorios permitidos.

Autor: Model Context Protocol
Funciona con: Any MCP client
Licencia: MIT
Documentado: Oct 2, 2026

Qué es Filesystem MCP Server

Servidor Node.js que implementa MCP para operaciones del sistema de archivos, publicado en npm como @modelcontextprotocol/server-filesystem. El acceso se limita a los directorios permitidos indicados como argumentos de línea de comandos o mediante MCP Roots.

Qué hace

Dónde se ejecuta Filesystem MCP Server y qué añade, según su documentación

Lee archivos de texto (con opciones head/tail) y archivos multimedia
Lee varios archivos a la vez
Escribe y sobrescribe archivos
Crea, lista y elimina directorios y mueve archivos o directorios
Busca archivos y obtiene metadatos
Actualiza los directorios permitidos en tiempo de ejecución mediante MCP Roots

Cuándo usarla

Buen encaje

Permitir que un agente trabaje en unas pocas carpetas concretas de un proyecto
Clientes que admiten Roots y necesitan cambiar directorios en tiempo de ejecución

No apto para

Cualquier cosa que necesite acceso fuera de los directorios permitidos
Uso en producción sin tu propia revisión: el README raíz indica que son implementaciones de referencia pensadas como ejemplos educativos, no soluciones listas para producción.

Cómo instalar Filesystem MCP Server

Necesitas: Node.js (npx); Al menos un directorio permitido mediante argumentos o Roots; de lo contrario falla al iniciar

Asegúrate de tener Node.js y npx disponibles
Añade el servidor a la configuración de tu cliente MCP con el comando npx
Pasa al menos un directorio permitido como argumento, o usa un cliente que admita Roots
Reinicia el cliente y llama a list_allowed_directories para confirmarlo

Ejemplo de configuración (de la documentación oficial)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/dir1",
        "/path/to/dir2"
      ]
    }
  }
}

Permisos y seguridad

A qué puede acceder

Lee y escribe archivos y directorios solo dentro de los directorios permitidos

Notas de seguridad de los responsables

write_file sobrescribe archivos existentes; el README pide precaución
El README raíz indica que son implementaciones de referencia pensadas como ejemplos educativos, no soluciones listas para producción.

Revisa el código fuente antes de dar a un agente acceso a credenciales o sistemas de producción. Documentamos lo que declaran los responsables; no auditamos el código.

Limitaciones

El servidor falla al iniciar si no se dan argumentos y el cliente no admite Roots
Los Roots del cliente reemplazan por completo los directorios de la línea de comandos

Preguntas frecuentes

¿Qué necesita el servidor MCP Filesystem para iniciar?

Al menos un directorio permitido, pasado como argumento o proporcionado por el cliente mediante Roots. fuente

¿Puede el servidor MCP Filesystem acceder a archivos fuera de los directorios permitidos?

No. El README dice que todas las operaciones están restringidas a los directorios permitidos. fuente

¿Cuál es el paquete de npm del servidor MCP Filesystem?

@modelcontextprotocol/server-filesystem. fuente

Guías relacionadas

Fuentes y lagunas

https://raw.githubusercontent.com/modelcontextprotocol/servers/main/src/filesystem/README.md readme, revisado Oct 2, 2026
https://raw.githubusercontent.com/modelcontextprotocol/servers/main/README.md readme, revisado Oct 2, 2026

No indicado por los responsables: Este README no nombra individualmente como compatibles con Claude Code/Cursor/Windsurf/Codex a otros hosts que no sean clientes MCP genéricos; La fecha de last_release no es visible en el README revisado.