Каталог MCP
efforthye/fast-filesystem-mcp

efforthye/fast-filesystem-mcp

MCP инструмент для файловой системы через Claude Desktop. Поддерживает чтение и запись больших файлов, пакетное редактирование с резервированием, поиск по содержимому. Полезен для автоматизации файловых операций.

README

25 инструментов

Версии

Установить сервер

Advanced filesystem operations for Claude Desktop with large file handling capabilities and Claude-optimized features.

Quick Start

Add to your Claude Desktop config.

Basic setup

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

With backup files enabled

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

Backup Configuration

Control backup file creation behavior.

CREATE_BACKUP_FILES=false (default): Disables backup file creation to reduce clutter
CREATE_BACKUP_FILES=true: Creates backup files before modifications

Note: Backup files are created with timestamps (e.g., file.txt.backup.1755485284402) to prevent data loss during edits.

Debug and Logging Configuration

The MCP server uses a safe logging system that prevents JSON-RPC communication errors.

Инструменты были проиндексированы: 04.09.2026

fast_batch_file_operations

Выполняет пакетные операции над несколькими файлами.

Параметры

create_backupboolean
Create backup before changes
dry_runboolean
Preview without actual execution
operationsobject[]обязательный
List of batch operations
stop_on_errorboolean
Stop on error

fast_compress_files

Сжимает файлы или каталоги

Параметры

compression_levelnumber
Compression level (0=store, 9=max)
exclude_patternsstring[]
Patterns to exclude (e.g., *.log, node_modules)
formatenum
Archive format
output_pathstringобязательный
Output archive file path
pathsstring[]обязательный
Paths of files/directories to compress

fast_copy_file

Копирует файл или каталог

Параметры

create_dirsboolean
Automatically create destination directories
destinationstringобязательный
Destination path
overwriteboolean
Overwrite existing file
preserve_timestampsboolean
Preserve timestamps
recursiveboolean
Recursively copy directory
sourcestringобязательный
Source file/directory path

fast_create_directory

Создаёт каталог.

Параметры

pathstringобязательный
Path of the directory to create
recursiveboolean
Create parent directories if they do not exist

fast_delete_file

Удаляет файл или каталог

Параметры

backup_before_deleteboolean
Create a backup before deleting
confirm_deleteboolean
Confirm deletion (safety measure)
forceboolean
Force deletion
pathstringобязательный
Path of the file/directory to delete
recursiveboolean
Recursively delete directory

fast_edit_block

Точное редактирование блоков: безопасно заменяет точные совпадения (в стиле desktop-commander)

Параметры

backupboolean
Create a backup
case_sensitiveboolean
Match case sensitively
expected_replacementsnumber
Expected number of replacements (safety guard)
new_textstringобязательный
Replacement text
old_textstringобязательный
Exact existing text to match (include minimal context)
pathstringобязательный
Path of the file to edit
preview_onlyboolean
Preview only (don’t modify the file)
word_boundaryboolean
Enforce word boundaries (prevents partial matches)

fast_edit_blocks

Обрабатывает множество точных блочных изменений за один раз (массив fast_edit_block)

Параметры

backupboolean
Create a backup
editsobject[]обязательный
List of precise block edits
pathstringобязательный
Path of the file to edit

fast_edit_multiple_blocks

Редактирует несколько частей файла одновременно

Параметры

backupboolean
Create a backup
editsobject[]обязательный
List of edit operations
pathstringобязательный
Path of the file to edit

fast_extract_archive

Извлекает архивный файл

Параметры

archive_pathstringобязательный
Archive file path
create_dirsboolean
Automatically create directories
extract_specificstring[]
Extract only specific files (optional)
extract_tostring
Directory to extract to
overwriteboolean
Overwrite existing files
preserve_permissionsboolean
Preserve permissions

fast_extract_lines

Извлекает конкретные строки из файла

Параметры

context_linesnumber
Number of context lines before and after a pattern match
end_linenumber
End line (for range extraction)
line_numbersnumber[]
Line numbers to extract
pathstringобязательный
File path
patternstring
Extract lines by pattern
start_linenumber
Start line (for range extraction)

fast_find_large_files

Находит большие файлы

Параметры

max_resultsnumber
Maximum number of results
min_sizestring
Minimum size (e.g., 100MB, 1GB)
pathstringобязательный
Directory to search in

fast_get_directory_tree

Получает структуру дерева каталогов.

Параметры

include_filesboolean
Include files in the tree
max_depthnumber
Maximum depth
pathstringобязательный
Root directory path
show_hiddenboolean
Show hidden files

fast_get_disk_usage

Получает информацию об использовании диска.

Параметры

pathstring
Path to check

fast_get_file_info

Получает подробную информацию о файле или каталоге

Параметры

pathstringобязательный
Path to get info for

fast_large_write_file

Надежно записывает большие файлы (с потоковой передачей, повторными попытками, резервным копированием и верификацией)

Параметры

appendboolean
Append mode
backupboolean
Create a backup of the existing file
chunk_sizenumber
Chunk size (bytes)
contentstringобязательный
File content
create_dirsboolean
Automatically create directories
encodingstring
Text encoding
force_remove_emojisboolean
Force remove emojis (default: false)
pathstringобязательный
File path
retry_attemptsnumber
Number of retry attempts
verify_writeboolean
Verify after writing

fast_list_allowed_directories

Перечисляет разрешённые каталоги

Параметры

Без параметров.

fast_list_directory

Выводит содержимое каталога (с поддержкой автоматического разбиения на блоки и постраничного вывода)

Параметры

auto_chunkboolean
Enable auto-chunking
continuation_tokenstring
Continuation token from a previous call
pagenumber
Page number
page_sizenumber
Number of items per page
pathstringобязательный
Directory path
patternstring
Filename filter pattern
reverseboolean
Reverse sort order
show_hiddenboolean
Show hidden files
sort_byenum
Sort by

fast_move_file

Перемещает или переименовывает файл или каталог

Параметры

backup_if_existsboolean
Create a backup if the destination file exists
create_dirsboolean
Automatically create destination directories
destinationstringобязательный
Destination path
overwriteboolean
Overwrite existing file
sourcestringобязательный
Source file/directory path

fast_read_file

Читает файл (с поддержкой автоматического разбиения на фрагменты)

Параметры

auto_chunkboolean
Enable auto-chunking
continuation_tokenstring
Continuation token from a previous call
encodingstring
Text encoding
line_countnumber
Number of lines to read
line_startnumber
Starting line number
max_sizenumber
Maximum size to read
pathstringобязательный
File path to read
start_offsetnumber
Starting byte offset

fast_read_multiple_files

Читает содержимое нескольких файлов одновременно (поддерживает последовательное чтение)

Параметры

auto_continueboolean
Automatically read the entire file (default: true)
chunk_sizenumber
Chunk size (bytes, default: 1MB)
continuation_tokensobject
Per-file continuation token (value returned from a previous call)
pathsstring[]обязательный
File paths to read

fast_safe_edit

Безопасное умное редактирование: Обнаруживает риски и предоставляет интерактивное подтверждение

Параметры

auto_add_contextboolean
Automatically add context
new_textstringобязательный
The new text
old_textstringобязательный
Text to be replaced
pathstringобязательный
Path of the file to edit
require_confirmationboolean
Require confirmation on high risk
safety_levelenum
Safety level (strict: very safe, moderate: balanced, flexible: lenient)

fast_search_code

Ищет код (в стиле ripgrep) — предоставляет автоматическое разбиение на части, номера строк и контекст

Параметры

auto_chunkboolean
Enable auto-chunking
case_sensitiveboolean
Case-sensitive search
context_linesnumber
Number of context lines around a match
continuation_tokenstring
Continuation token from a previous call
file_patternstring
File extension filter (e.g., *.js, *.ts)
include_hiddenboolean
Include hidden files
max_file_sizenumber
Maximum file size to search (in MB)
max_resultsnumber
Maximum number of results
pathstringобязательный
Directory to search in
patternstringобязательный
Search pattern (regex supported)

fast_search_files

Ищет файлы (по имени/содержимому) - поддерживает автоматическое разбиение на чанки, регулярные выражения, контекст и номера строк

Параметры

auto_chunkboolean
Enable auto-chunking
case_sensitiveboolean
Case-sensitive search
content_searchboolean
Search file content
context_linesnumber
Number of context lines around a match
continuation_tokenstring
Continuation token from a previous call
file_patternstring
Filename filter pattern (e.g., *.js, *.txt)
include_binaryboolean
Include binary files in search
max_resultsnumber
Maximum number of results
pathstringобязательный
Directory to search in
patternstringобязательный
Search pattern (regex supported)

fast_sync_directories

Синхронизирует две директории

Параметры

delete_extraboolean
Delete files that only exist in the target
dry_runboolean
Preview without actual execution
exclude_patternsstring[]
Patterns to exclude
preserve_newerboolean
Preserve newer files
source_dirstringобязательный
Source directory
sync_modeenum
Synchronization mode
target_dirstringобязательный
Target directory

fast_write_file

Пишет или изменяет файл (содержит правила использования эмодзи)

Параметры

appendboolean
Append mode
contentstringобязательный
File content
create_dirsboolean
Automatically create directories
encodingstring
Text encoding
force_remove_emojisboolean
Force remove emojis (default: false)
pathstringобязательный
File path

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер даёт Claude Desktop полноценный доступ к файловой системе: чтение больших файлов, пакетное редактирование, поиск и архивацию. Вместо куцых базовых операций он позволяет агенту работать с файлами любого размера, создавать резервные копии и выполнять сложные сценарии, не рискуя сломать JSON-RPC. Всё заточено под реальные задачи разработчика.

Что он умеет?

Работает с файлами и директориями: читает одиночные, множественные и большие файлы по частям, пишет и перезаписывает, надёжно сохраняет крупные файлы стримингом с бэкапами и проверкой. Точечно редактирует строки и блоки, правит несколько блоков за раз, извлекает строки. Создаёт, копирует, перемещает и удаляет файлы и папки, выполняет пакетные операции, синхронизирует директории. Ищет файлы по имени и содержимому, код через ripgrep, находит крупные файлы. Упаковывает и распаковывает архивы, показывает дерево каталогов, занятость диска и разрешённые директории.