fast-filesystem-mcp

Быстрый старт

Добавьте в конфигурацию Claude Desktop.

• Базовая настройка

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

• С включенными резервными файлами

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

Конфигурация резервного копирования

Управление созданием резервных файлов.

• CREATE_BACKUP_FILES=false (по умолчанию): Отключает создание резервных файлов для уменьшения беспорядка

• CREATE_BACKUP_FILES=true: Создает резервные файлы перед внесением изменений

Примечание: Резервные файлы создаются с метками времени (например, file.txt.backup.1755485284402) для предотвращения потери данных во время редактирования.

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

MCP-сервер использует безопасную систему логирования, которая предотвращает ошибки связи JSON-RPC.

• DEBUG_MCP=true или MCP_DEBUG=true: Включить отладочное логирование в stderr

• MCP_LOG_FILE=/path/to/log.txt: Записывать логи в файл вместо stderr

• MCP_SILENT_ERRORS=true или SILENT_ERRORS=true: Подавлять сообщения об ошибках в ответах

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

Related MCP server: Code Buddy

Обновление версии

Чтобы обновиться до последней версии, выполните следующие шаги.

1. Удалите предыдущую версию

   npm uninstall -g fast-filesystem-mcp

2. Очистите кэш и зависимости

   npm cache clean --force
   pnpm store prune

3. Установите последнюю версию

   npm install -g fast-filesystem-mcp

4. Проверьте установку

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

Функции

Основные операции с файлами

• Быстрое чтение/запись файлов: Оптимизировано для Claude Desktop с поддержкой разбиения на части (chunking)

• Последовательное чтение: Полное чтение больших файлов с поддержкой токенов продолжения

• Обработка больших файлов: Потоковая запись для файлов любого размера

• Операции с директориями: Полный список, создание и управление директориями

• Поиск файлов: Поиск файлов по имени и содержимому с фильтрацией

Расширенные возможности

• Поддержка пагинации: Эффективная работа с большими директориями

• Чтение по частям: Чтение больших файлов управляемыми порциями

• Потоковая запись: Эффективная по памяти запись для больших файлов

• Резервное копирование и восстановление: Автоматическое создание резервных копий и восстановление после ошибок

• Логика повторных попыток: Встроенный механизм повторов для надежных операций

Оптимизация производительности

• Оптимизировано для Claude: Размеры и форматы ответов оптимизированы для Claude

• Эффективность памяти: Потоковые операции предотвращают переполнение памяти

• Умные исключения: Автоматически исключает системные файлы и директории

• Отслеживание прогресса: Мониторинг прогресса в реальном времени для больших операций

Доступные инструменты

Операции с файлами

Сложное управление файлами

Управление архивами

Синхронизация директорий

Расширенные инструменты редактирования

Операции с директориями

Операции поиска

Системные операции

Инструменты редактирования

Точное редактирование файлов

fast-filesystem MCP теперь включает мощные инструменты редактирования для исходного кода и текстовых файлов.

fast_edit_file - Редактирование одного блока

Поддерживает несколько режимов редактирования.

• replace: Замена текста или целых строк

• replace_range: Замена нескольких строк одновременно

• insert_before: Вставка содержимого перед указанной строкой

• insert_after: Вставка содержимого после указанной строки

• delete_line: Удаление определенных строк

{
  "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 - Пакетное редактирование

Редактирование нескольких частей файла за одну операцию.

{
  "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 - Извлечение строк

Извлечение определенных строк по номеру, диапазону или шаблону.

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

fast_search_and_replace - Расширенная замена

Мощный поиск и замена с поддержкой регулярных выражений.

{
  "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
  }
}

Функции редактирования

• Автоматическое резервное копирование: Создает резервные копии перед внесением изменений

• Восстановление после ошибок: Восстановление из резервной копии при сбое

• Построчные операции: Точный контроль над конкретными строками

• Сопоставление с шаблоном: Поддержка регулярных выражений

• Пакетные операции: Несколько правок в одной транзакции

• Извлечение контекста: Извлечение строк с окружающим контекстом

Запись больших файлов

• fast_large_write_file

  • Потоковая передача: Записывает файлы частями для предотвращения проблем с памятью

  • Резервное копирование: Автоматически создает резервные копии перед перезаписью

  • Проверка: Проверяет целостность файла после записи

  • Логика повторных попыток: Автоматический повтор при сбое с экспоненциальной задержкой

  • Отслеживание прогресса: Мониторинг прогресса записи в реальном времени

Лицензия

Apache 2.0

Copyright 2025 efforthye

Лицензировано по лицензии Apache License, Version 2.0 ("Лицензия"); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу

Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение распространяемое по Лицензии, предоставляется на условиях "КАК ЕСТЬ", БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых. См. Лицензию для получения информации о конкретных разрешениях и ограничениях в рамках Лицензии.

Значок

Репозиторий

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