Skip to main content
Glama
fast-filesystem-mcp
by efforthye

Inicio rápido

Añádelo a tu configuración de Claude Desktop.

  • Configuración básica

{
  "mcpServers": {
    "fast-filesystem": {
      "command": "npx",
      "args": ["-y", "fast-filesystem-mcp"]
    }
  }
}
  • Con archivos de copia de seguridad habilitados

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

Configuración de copias de seguridad

Controla el comportamiento de creación de archivos de copia de seguridad.

  • CREATE_BACKUP_FILES=false (predeterminado): Deshabilita la creación de archivos de copia de seguridad para reducir el desorden

  • CREATE_BACKUP_FILES=true: Crea archivos de copia de seguridad antes de realizar modificaciones

Nota: Los archivos de copia de seguridad 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 evita 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 los registros en un archivo en lugar de en stderr

  • MCP_SILENT_ERRORS=true o SILENT_ERRORS=true: Suprime los 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.

Related MCP server: Code Buddy

Actualización de nueva versión

Para actualizar a la última versión, sigue estos pasos.

  1. Desinstalar la versión anterior

    npm uninstall -g fast-filesystem-mcp
  2. Limpiar caché y dependencias

    npm cache clean --force
    pnpm store prune
  3. Instalar la última versión

    npm install -g fast-filesystem-mcp
  4. Verificar la instalación

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

Características

Operaciones principales de archivos

  • Lectura/Escritura rápida de archivos: Optimizado para Claude Desktop con soporte para fragmentación

  • Lectura secuencial: Lee archivos grandes completamente con soporte para tokens de continuación

  • Manejo de archivos grandes: Escritura basada en streaming para archivos de cualquier tamaño

  • Operaciones de directorio: Listado, creación y gestión integral de directorios

  • Búsqueda de archivos: Búsqueda de archivos basada en 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 streaming: Escritura eficiente en memoria para archivos grandes

  • Copia de seguridad y recuperación: Creación automática de copias de seguridad y recuperación de errores

  • Lógica de reintento: Mecanismo de reintento integrado para operaciones fiables

Optimizaciones de rendimiento

  • Optimizado para Claude: Tamaños y formatos de respuesta optimizados para Claude

  • Eficiente en memoria: Las operaciones de streaming evitan el desbordamiento de memoria

  • Exclusiones inteligentes: Excluye automáticamente archivos y directorios del sistema

  • Seguimiento del progreso: Monitoreo del progreso en tiempo real para operaciones grandes

Herramientas disponibles

Operaciones de archivos

Herramienta

Descripción

fast_read_file

Leer archivos con soporte para fragmentación

fast_read_multiple_files

Leer múltiples archivos simultáneamente con soporte para lectura secuencial

fast_write_file

Escribir o modificar archivos

fast_large_write_file

Escritura basada en streaming para archivos grandes

fast_get_file_info

Obtener información detallada del archivo

Gestión compleja de archivos

Herramienta

Descripción

fast_copy_file

Copiar archivos y directorios con opciones avanzadas

fast_move_file

Mover/renombrar archivos y directorios de forma segura

fast_delete_file

Eliminar archivos y directorios con protección

fast_batch_file_operations

Ejecutar múltiples operaciones de archivo en secuencia

Gestión de archivos comprimidos

Herramienta

Descripción

fast_compress_files

Crear archivos comprimidos (tar, tar.gz, tar.bz2)

fast_extract_archive

Extraer 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 de bloques por lotes para múltiples cambios precisos

fast_edit_multiple_blocks

Editar múltiples secciones en una sola operación

fast_extract_lines

Extraer líneas o rangos específicos de archivos

Operaciones de directorio

Herramienta

Descripción

fast_list_directory

Listar el contenido del directorio con paginación

fast_create_directory

Crear directorios de forma recursiva

fast_get_directory_tree

Obtener la estructura del árbol de directorios

Operaciones de búsqueda

Herramienta

Descripción

fast_search_files

Buscar archivos por nombre o contenido

fast_search_code

Búsqueda avanzada de código con integración de ripgrep

fast_find_large_files

Encontrar archivos grandes en directorios

Operaciones del sistema

Herramienta

Descripción

fast_get_disk_usage

Comprobar información de uso del disco

fast_list_allowed_directories

Listar directorios permitidos

Herramientas de edición

Edición precisa de archivos

El MCP fast-filesystem ahora incluye potentes herramientas de edición para código fuente y archivos de texto.

fast_edit_file - Edición de un solo bloque

Admite múltiples modos de edición.

  • replace: Reemplazar texto o líneas completas

  • replace_range: Reemplazar varias líneas a la vez

  • insert_before: Insertar contenido antes de la línea especificada

  • insert_after: Insertar contenido después de la línea especificada

  • delete_line: Eliminar 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

Editar 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

Extraer 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 para 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
  }
}

Características de edición

  • Copia de seguridad automática: Crea copias de seguridad antes de las modificaciones

  • Recuperación de errores: Restaura desde la copia de seguridad en caso de fallo

  • Operaciones basadas en líneas: Control preciso sobre líneas específicas

  • Coincidencia de patrones: Soporte para expresiones regulares

  • Operaciones por lotes: Múltiples ediciones en una sola transacción

  • Extracción de contexto: Extraer líneas con el contexto circundante

Escritura de archivos grandes

  • fast_large_write_file

    • Streaming: Escribe archivos en fragmentos para evitar problemas de memoria

    • Copia de seguridad: Crea automáticamente copias de seguridad 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 del progreso: Monitoreo en tiempo real del progreso de escritura

Licencia

Apache 2.0

Copyright 2025 efforthye

Con licencia bajo la Licencia Apache, Versión 2.0 (la "Licencia"); no puede utilizar este archivo excepto en cumplimiento con la Licencia. Puede obtener una copia de la Licencia en

A menos 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. Consulte la Licencia para conocer los permisos específicos y las limitaciones bajo la Licencia.

Insignia

Listed on Spark

Repositorio

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

Available Tools

25 tools
fast_batch_file_operationsC

Performs batch operations on multiple files

Inputs: operations (required), stop_on_error, dry_run, create_backup.

fast_compress_filesC

Compresses files or directories

Inputs: paths (required), output_path (required), format, compression_level, +1 more.

fast_copy_fileC

Copies a file or directory

Inputs: source (required), destination (required), overwrite, preserve_timestamps, +2 more.

fast_create_directoryC

Creates a directory

Inputs: path (required), recursive.

fast_delete_fileC

Deletes a file or directory

Inputs: path (required), recursive, force, backup_before_delete, +1 more.

fast_edit_blockC

Precise block editing: safely replace exact matches (desktop-commander style)

Inputs: path (required), old_text (required), new_text (required), expected_replacements, +4 more.

fast_edit_blocksC

Processes multiple precise block edits at once (array of fast_edit_block)

Inputs: path (required), edits (required), backup.

fast_edit_multiple_blocksC

Edits multiple parts of a file at once

Inputs: path (required), edits (required), backup.

fast_extract_archiveC

Extracts an archive file

Inputs: archive_path (required), extract_to, overwrite, create_dirs, +2 more.

fast_extract_linesD

Extracts specific lines from a file

Inputs: path (required), line_numbers, start_line, end_line, +2 more.

fast_find_large_filesC

Finds large files

Inputs: path (required), min_size, max_results.

fast_get_directory_treeC

Gets the directory tree structure

Inputs: path (required), max_depth, show_hidden, include_files.

fast_get_disk_usageC

Gets disk usage information

Inputs: path.

fast_get_file_infoB

Gets detailed information about a file or directory

Inputs: path (required).

fast_large_write_fileA

Reliably writes large files (with streaming, retry, backup, and verification features)

Inputs: path (required), content (required), encoding, create_dirs, +6 more.

fast_list_allowed_directoriesB

Lists the allowed directories

Inputs: no named parameters.

fast_list_directoryB

Lists the contents of a directory (with auto-chunking and pagination support)

Inputs: path (required), page, page_size, pattern, +5 more.

fast_move_fileB

Moves or renames a file or directory

Inputs: source (required), destination (required), overwrite, create_dirs, +1 more.

fast_read_fileB

Reads a file (with auto-chunking support)

Inputs: path (required), start_offset, max_size, line_start, +4 more.

fast_read_multiple_filesB

Reads the content of multiple files simultaneously (supports sequential reading)

Inputs: paths (required), continuation_tokens, auto_continue, chunk_size.

fast_safe_editB

Safe smart editing: Detects risks and provides interactive confirmation

Inputs: path (required), old_text (required), new_text (required), safety_level, +2 more.

fast_search_codeB

Searches for code (ripgrep-style) - provides auto-chunking, line numbers, and context

Inputs: path (required), pattern (required), file_pattern, context_lines, +6 more.

fast_search_filesB

Searches for files (by name/content) - supports auto-chunking, regex, context, and line numbers

Inputs: path (required), pattern (required), content_search, case_sensitive, +6 more.

fast_sync_directoriesC

Synchronizes two directories

Inputs: source_dir (required), target_dir (required), sync_mode, delete_extra, +3 more.

fast_write_fileC

Writes or modifies a file (provides emoji guidelines)

Inputs: path (required), content (required), encoding, create_dirs, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 25 tools

    Disambiguation3/5

    Most tools are distinct, but there is notable overlap between fast_edit_block, fast_safe_edit, fast_edit_multiple_blocks, and fast_edit_blocks—all handle editing and could confuse an agent. Similarly, fast_search_files and fast_search_code have overlapping purposes despite different descriptions.

    Naming Consistency4/5

    The fast_ prefix is applied consistently and most tools follow a verb_noun pattern (e.g., fast_read_file, fast_create_directory). Minor deviations like fast_edit_blocks vs fast_edit_multiple_blocks and fast_batch_file_operations are slightly inconsistent but still readable.

    Tool Count3/5

    25 tools is at the upper boundary of what is reasonable for a filesystem server. The count feels heavy because several tools overlap (multiple edit variants, two search tools, multiple read/write variants), but each has a plausible use case.

    Completeness5/5

    The tool surface covers the full filesystem lifecycle: read, write, edit, list, search, create, copy, move, delete, batch operations, compression, sync, and disk usage. There are no obvious dead ends for common file operations.

    Maintenance

    ActivityInactive
    ResponsivenessMostly unanswered

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
      15
      305
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A comprehensive MCP server that provides AI assistants with tools for file system management, Git integration, and shell command execution. It features specialized code utilities for analysis, formatting, and linting to enhance development workflows within Claude Desktop.
      28
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A comprehensive MCP server that enables AI models to perform local file operations, command execution, and task management across multiple platforms. It features advanced capabilities like row-level file editing, directory searching, and system monitoring with built-in security filters.
      13
      48 npm
      Mulan Permissive Software , Version 2
    • A
      license
      Not graded
      quality
      D
      maintenance
      A tuned filesystem MCP server for Codex-style development, offering fast file operations, bounded output, and safe edits.
      MIT