Fast Filesystem MCP

Un servidor de alto rendimiento del Protocolo de Contexto de Modelo (MCP) que proporciona acceso seguro al sistema de archivos y herramientas de desarrollo de código optimizadas para IA para Claude y otros asistentes de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

Operaciones avanzadas de sistema de archivos para Claude Desktop con capacidades de manejo de archivos grandes y funciones optimizadas para Claude.

Inicio rápido

Agrega a tu configuración de Claude Desktop.

Configuración básica

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}

Con archivos de respaldo habilitados

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"],
      "env": {
        "CREATE_BACKUP_FILES": "true"
      }
    }
  }
}

Configuración de respaldo

Controla el comportamiento de creación de archivos de respaldo.

CREATE_BACKUP_FILES=false (predeterminado): Desactiva la creación de archivos de respaldo para reducir el desorden
CREATE_BACKUP_FILES=true: Crea archivos de respaldo antes de las modificaciones

Nota: Los archivos de respaldo se crean con marcas de tiempo (p. ej., file.txt.backup.1755485284402) para evitar la pérdida de datos durante las ediciones.

Configuración de depuración y registro

El servidor MCP utiliza un sistema de registro seguro que previene errores de comunicación JSON-RPC.

DEBUG_MCP=true o MCP_DEBUG=true: Habilita el registro de depuración en stderr
MCP_LOG_FILE=/path/to/log.txt: Escribe registros en un archivo en lugar de stderr
MCP_SILENT_ERRORS=true o SILENT_ERRORS=true: Suprime mensajes de error en las respuestas

Nota: La salida de depuración se suprime automáticamente de forma predeterminada para evitar errores de análisis JSON en Claude Desktop.

Actualización a la nueva versión

Para actualizar a la versión más reciente, sigue estos pasos.

Desinstala la versión anterior
```
npm uninstall -g fast-filesystem-mcp
```

Limpia la caché y las dependencias

npm cache clean --force
pnpm store prune

Instala la versión más reciente
```
npm install -g fast-filesystem-mcp
```

Verifica la instalación

npm list -g fast-filesystem-mcp
fast-filesystem-mcp --version

Funciones

Operaciones básicas de archivos

Lectura/Escritura rápida de archivos: Optimizada para Claude Desktop con soporte de fragmentación
Lectura secuencial: Lee archivos grandes por completo con soporte de token de continuación
Manejo de archivos grandes: Escritura basada en flujo para archivos de cualquier tamaño
Operaciones de directorio: Listado, creación y gestión integral de directorios
Búsqueda de archivos: Búsqueda por nombre y contenido con filtrado

Capacidades avanzadas

Soporte de paginación: Maneja directorios grandes de manera eficiente
Lectura fragmentada: Lee archivos grandes en fragmentos manejables
Escrituras en flujo: Escritura eficiente en memoria para archivos grandes
Respaldo y recuperación: Creación automática de respaldos y recuperación de errores
Lógica de reintento: Mecanismo de reintento integrado para operaciones confiables

Optimizaciones de rendimiento

Optimizado para Claude: Tamaños y formatos de respuesta optimizados para Claude
Eficiente en memoria: Las operaciones en flujo previenen el desbordamiento de memoria
Exclusiones inteligentes: Excluye automáticamente archivos y directorios del sistema
Seguimiento de progreso: Monitoreo de progreso en tiempo real para operaciones grandes

Herramientas disponibles

Operaciones de archivos

Herramienta	Descripción
`fast_read_file`	Lee archivos con soporte de fragmentación
`fast_read_multiple_files`	Lee múltiples archivos simultáneamente con soporte de lectura secuencial
`fast_write_file`	Escribe o modifica archivos
`fast_large_write_file`	Escritura basada en flujo para archivos grandes
`fast_get_file_info`	Obtiene información detallada de archivos

Gestión compleja de archivos

Herramienta	Descripción
`fast_copy_file`	Copia archivos y directorios con opciones avanzadas
`fast_move_file`	Mueve/renombra archivos y directorios de forma segura
`fast_delete_file`	Elimina archivos y directorios con protección
`fast_batch_file_operations`	Ejecuta múltiples operaciones de archivos en secuencia

Gestión de archivos comprimidos

Herramienta	Descripción
`fast_compress_files`	Crea archivos comprimidos (tar, tar.gz, tar.bz2)
`fast_extract_archive`	Extrae archivos comprimidos con opciones

Sincronización de directorios

Herramienta	Descripción
`fast_sync_directories`	Sincronización avanzada de directorios con múltiples modos

Herramientas de edición avanzada

Herramienta	Descripción
`fast_edit_file`	Edición precisa de archivos basada en líneas con múltiples modos
`fast_edit_block`	Edición segura de bloques con coincidencia exacta de cadenas
`fast_edit_blocks`	Edición por lotes de bloques para múltiples cambios precisos
`fast_edit_multiple_blocks`	Edita múltiples secciones en una sola operación
`fast_extract_lines`	Extrae líneas o rangos específicos de archivos

Operaciones de directorio

Herramienta	Descripción
`fast_list_directory`	Lista el contenido del directorio con paginación
`fast_create_directory`	Crea directorios de forma recursiva
`fast_get_directory_tree`	Obtiene la estructura de árbol del directorio

Operaciones de búsqueda

Herramienta	Descripción
`fast_search_files`	Busca archivos por nombre o contenido
`fast_search_code`	Búsqueda avanzada de código con integración de ripgrep
`fast_find_large_files`	Encuentra archivos grandes en directorios

Operaciones del sistema

Herramienta	Descripción
`fast_get_disk_usage`	Verifica información de uso del disco
`fast_list_allowed_directories`	Lista directorios permitidos

Herramientas de edición

Edición precisa de archivos

El MCP de sistema de archivos rápido ahora incluye potentes herramientas de edición para código fuente y archivos de texto.

`fast_edit_file` - Edición de bloque único

Soporta múltiples modos de edición.

replace: Reemplaza texto o líneas completas
replace_range: Reemplaza múltiples líneas a la vez
insert_before: Inserta contenido antes de la línea especificada
insert_after: Inserta contenido después de la línea especificada
delete_line: Elimina líneas específicas

{
  "tool": "fast_edit_file",
  "arguments": {
    "path": "/path/to/file.js",
    "mode": "replace",
    "line_number": 10,
    "new_text": "const newVariable = 'updated value';",
    "backup": true
  }
}

`fast_edit_multiple_blocks` - Edición por lotes

Edita múltiples partes de un archivo en una sola operación.

{
  "tool": "fast_edit_multiple_blocks", 
  "arguments": {
    "path": "/path/to/file.js",
    "edits": [
      {
        "mode": "replace",
        "old_text": "oldFunction()",
        "new_text": "newFunction()"
      },
      {
        "mode": "insert_after",
        "line_number": 5,
        "new_text": "// Added comment"
      }
    ],
    "backup": true
  }
}

`fast_extract_lines` - Extracción de líneas

Extrae líneas específicas por número, rango o patrón.

{
  "tool": "fast_extract_lines",
  "arguments": {
    "path": "/path/to/file.js",
    "pattern": "function.*",
    "context_lines": 2
  }
}

`fast_search_and_replace` - Reemplazo avanzado

Potente búsqueda y reemplazo con soporte de expresiones regulares.

{
  "tool": "fast_search_and_replace",
  "arguments": {
    "path": "/path/to/file.js", 
    "search_pattern": "console\\.log\\(.*\\)",
    "replace_text": "logger.info($1)",
    "use_regex": true,
    "max_replacements": 10,
    "backup": true
  }
}

Funciones de edición

Respaldo automático: Crea respaldos antes de las modificaciones
Recuperación de errores: Restaura desde el respaldo en caso de fallo
Operaciones basadas en líneas: Control preciso sobre líneas específicas
Coincidencia de patrones: Soporte de expresiones regulares
Operaciones por lotes: Múltiples ediciones en una sola transacción
Extracción de contexto: Extrae líneas con contexto circundante

Escritura de archivos grandes

fast_large_write_file
- Transmisión: Escribe archivos en fragmentos para prevenir problemas de memoria
- Respaldo: Crea respaldos automáticamente antes de sobrescribir
- Verificación: Verifica la integridad del archivo después de escribir
- Lógica de reintento: Reintento automático en caso de fallo con retroceso exponencial
- Seguimiento de progreso: Monitoreo en tiempo real del progreso de escritura

Licencia

Apache 2.0

Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia"); no puedes usar este archivo excepto en cumplimiento con la Licencia. Puedes obtener una copia de la Licencia en

Salvo que lo exija la ley aplicable o se acuerde por escrito, el software distribuido bajo la Licencia se distribuye "TAL CUAL", SIN GARANTÍAS NI CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Consulta la Licencia para conocer los permisos y limitaciones específicos bajo la Licencia.

Repositorio

https://github.com/efforthye/fast-filesystem-mcp