fast-filesystem-mcp
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 desordenCREATE_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=trueoMCP_DEBUG=true: Habilita el registro de depuración en stderrMCP_LOG_FILE=/path/to/log.txt: Escribe los registros en un archivo en lugar de en stderrMCP_SILENT_ERRORS=trueoSILENT_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.
Desinstalar la versión anterior
npm uninstall -g fast-filesystem-mcpLimpiar caché y dependencias
npm cache clean --force pnpm store pruneInstalar la última versión
npm install -g fast-filesystem-mcpVerificar 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 |
| Leer archivos con soporte para fragmentación |
| Leer múltiples archivos simultáneamente con soporte para lectura secuencial |
| Escribir o modificar archivos |
| Escritura basada en streaming para archivos grandes |
| Obtener información detallada del archivo |
Gestión compleja de archivos
Herramienta | Descripción |
| Copiar archivos y directorios con opciones avanzadas |
| Mover/renombrar archivos y directorios de forma segura |
| Eliminar archivos y directorios con protección |
| Ejecutar múltiples operaciones de archivo en secuencia |
Gestión de archivos comprimidos
Herramienta | Descripción |
| Crear archivos comprimidos (tar, tar.gz, tar.bz2) |
| Extraer archivos comprimidos con opciones |
Sincronización de directorios
Herramienta | Descripción |
| Sincronización avanzada de directorios con múltiples modos |
Herramientas de edición avanzada
Herramienta | Descripción |
| Edición precisa de archivos basada en líneas con múltiples modos |
| Edición segura de bloques con coincidencia exacta de cadenas |
| Edición de bloques por lotes para múltiples cambios precisos |
| Editar múltiples secciones en una sola operación |
| Extraer líneas o rangos específicos de archivos |
Operaciones de directorio
Herramienta | Descripción |
| Listar el contenido del directorio con paginación |
| Crear directorios de forma recursiva |
| Obtener la estructura del árbol de directorios |
Operaciones de búsqueda
Herramienta | Descripción |
| Buscar archivos por nombre o contenido |
| Búsqueda avanzada de código con integración de ripgrep |
| Encontrar archivos grandes en directorios |
Operaciones del sistema
Herramienta | Descripción |
| Comprobar información de uso del disco |
| 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_fileStreaming: 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
Repositorio
Available Tools
25 toolsfast_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
Scored across 25 tools
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.
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.
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.
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
Related MCP Connectors
Cloud-hosted MCP server for durable AI memory
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Hosted MySQL MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseAqualityDmaintenanceAn 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.15305MIT
- AlicenseCqualityDmaintenanceA 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.287MIT
- AlicenseAqualityCmaintenanceA 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.1348 npmMulan Permissive Software , Version 2
- AlicenseNot gradedqualityDmaintenanceA tuned filesystem MCP server for Codex-style development, offering fast file operations, bounded output, and safe edits.MIT