Filesystem MCP

Name: Filesystem MCP
Author: j0hanz

by j0hanz

Permite a tu IA leer, escribir y gestionar archivos locales de forma segura

filesystem Node.js Principiante Auto-hospedable Sin API key Verificado

📅 Actualizado: hace 2sem

Ver en GitHub Ver paquete

Descripción

Filesystem MCP es uno de los bloques de construcción fundamentales del ecosistema MCP. Otorga a los asistentes de IA la capacidad de leer, escribir, crear, mover y buscar archivos en tu máquina local a través de una interfaz controlada y consciente de permisos. En lugar de depender de que la IA genere contenido de archivos que luego copias y pegas manualmente, Filesystem MCP permite que el modelo trabaje directamente con los archivos de tu proyecto. El server opera dentro de límites de directorio explícitamente definidos. Cuando lo configuras, especificas a qué directorios puede acceder la IA, y no puede escapar de esos límites. Este enfoque de sandbox significa que obtienes los beneficios de productividad de las operaciones de archivos con IA sin el riesgo de cambios no deseados en archivos del sistema u otros proyectos. Cada operación está acotada y es auditable. Más allá de la lectura y escritura básicas, Filesystem MCP incluye utilidades prácticas que lo hacen genuinamente útil para el desarrollo del día a día. La herramienta `search_files` permite a la IA encontrar archivos por coincidencia de patrones a lo largo de tu proyecto. La herramienta `edit_file` habilita modificaciones quirúrgicas en archivos existentes sin reescribirlos completamente. Y `read_multiple_files` permite a la IA recopilar contexto de varios archivos a la vez de forma eficiente, algo esencial para entender cómo se relacionan las diferentes partes de un codebase.

✅ Ideal para

Cualquier desarrollador que use asistentes de IA compatibles con MCP y quiera que el modelo interactúe con los archivos del proyecto directamente en lugar de solo generar fragmentos de código

⏭️ No recomendado si

Solo trabajas con archivos en la nube o necesitas almacenamiento a nivel de base de datos — busca servers MCP especializados para esos casos de uso

💡 Casos de uso

Crear scaffolding de nuevos proyectos dejando que la IA genere estructuras de directorios y archivos boilerplate
Operaciones de refactoring que tocan múltiples archivos, como renombrar un módulo y actualizar todos los imports
Buscar entre archivos del proyecto para reunir contexto antes de hacer cambios en el código

👍 Ventajas

✓ Sandboxed por diseño — la IA solo puede acceder a directorios que tú permitas explícitamente
✓ Incluye búsqueda de archivos y lectura multi-archivo para exploración eficiente del codebase
✓ Edición quirúrgica de archivos sin necesidad de reescribirlos enteros

👎 Desventajas

✗ Restringido al sistema de archivos local — sin soporte para almacenamiento remoto o en la nube
✗ Las operaciones con archivos grandes pueden alcanzar los límites de tokens dependiendo del tamaño

🔧 Herramientas expuestas (10 herramientas)

Tool	Categoría	Descripción
create_directory	management	Crear un nuevo directorio, incluyendo los directorios padre necesarios
move_file	management	Mover o renombrar un archivo o directorio a una nueva ubicacion
delete_file	management	Eliminar un archivo o directorio vacio en la ruta especificada
read_file	read	Leer el contenido completo de un archivo en la ruta especificada
list_directory	read	Listar todos los archivos y subdirectorios dentro de un directorio dado
get_file_info	read	Obtener metadatos de un archivo incluyendo tamanio, fecha de modificacion y permisos
read_multiple_files	read	Leer el contenido de varios archivos a la vez para recopilar contexto de forma eficiente
search_files	search	Buscar archivos que coincidan con un patron de nombre en los directorios permitidos
write_file	write	Crear o sobrescribir un archivo con el contenido proporcionado
edit_file	write	Aplicar ediciones especificas a un archivo existente usando reemplazos basados en patrones

⚡ Instalación

Requisitos previos:

• Node.js

claude mcp add filesystem -- npx @anthropic-ai/filesystem-mcp@latest /path/to/allowed/dir

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/filesystem-mcp@latest", "/path/to/allowed/dir"]
    }
  }
}

💡 Consejos y trucos

Configura los directorios permitidos de la forma más específica posible. En lugar de dar acceso a todo tu directorio home, apunta a las raíces de proyectos individuales. Esto mantiene a la IA enfocada y reduce la posibilidad de modificaciones accidentales. Cuando necesites que la IA entienda un codebase complejo, empieza pidiéndole que use `search_files` y `read_multiple_files` para construir contexto antes de hacer cambios. La herramienta `edit_file` es particularmente útil para cambios pequeños y específicos en archivos grandes donde reescribir el archivo entero sería un desperdicio.

Info rápida

Autor: j0hanz
Licencia
Runtime: Node.js
Transporte: stdio
Categoría: filesystem
Dificultad: Principiante
Auto-hospedable: ✅
API key: No necesita API key
Docker: —
Versión: 1.5.1
Actualizado: 5 feb 2026

Compatibilidad con clientes

✅ Claude Code
✅ Cursor
✅ VS Code Copilot
✅ Gemini CLI
✅ Windsurf
✅ Cline
✅ JetBrains AI
✅ Warp

Enlaces

Plataformas

🍎 macOS 🐧 Linux 🪟 Windows