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

빠른 시작

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: 응답에서 오류 메시지를 숨깁니다.

참고: Claude Desktop에서 JSON 파싱 오류를 방지하기 위해 디버그 출력은 기본적으로 자동으로 억제됩니다.

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에 최적화됨

  • 순차 읽기: 연속 토큰 지원을 통해 대용량 파일을 완전히 읽음

  • 대용량 파일 처리: 모든 크기의 파일에 대한 스트림 기반 쓰기

  • 디렉토리 작업: 포괄적인 디렉토리 나열, 생성 및 관리

  • 파일 검색: 필터링을 포함한 이름 및 내용 기반 파일 검색

고급 기능

  • 페이지네이션 지원: 대용량 디렉토리를 효율적으로 처리

  • 청크 읽기: 대용량 파일을 관리 가능한 단위로 읽기

  • 스트리밍 쓰기: 대용량 파일에 대한 메모리 효율적인 쓰기

  • 백업 및 복구: 자동 백업 생성 및 오류 복구

  • 재시도 로직: 안정적인 작업을 위한 내장 재시도 메커니즘

성능 최적화

  • Claude 최적화: Claude에 최적화된 응답 크기 및 형식

  • 메모리 효율성: 스트리밍 작업을 통해 메모리 오버플로우 방지

  • 스마트 제외: 시스템 파일 및 디렉토리를 자동으로 제외

  • 진행 상황 추적: 대규모 작업에 대한 실시간 진행 상황 모니터링

사용 가능한 도구

파일 작업

도구

설명

fast_read_file

청크 지원을 통해 파일 읽기

fast_read_multiple_files

순차 읽기 지원을 통해 여러 파일을 동시에 읽기

fast_write_file

파일 쓰기 또는 수정

fast_large_write_file

대용량 파일을 위한 스트림 기반 쓰기

fast_get_file_info

상세 파일 정보 가져오기

복합 파일 관리

도구

설명

fast_copy_file

고급 옵션을 사용하여 파일 및 디렉토리 복사

fast_move_file

파일 및 디렉토리를 안전하게 이동/이름 변경

fast_delete_file

보호 기능을 사용하여 파일 및 디렉토리 삭제

fast_batch_file_operations

여러 파일 작업을 순차적으로 실행

아카이브 관리

도구

설명

fast_compress_files

압축 아카이브 생성 (tar, tar.gz, tar.bz2)

fast_extract_archive

옵션을 사용하여 압축 아카이브 추출

디렉토리 동기화

도구

설명

fast_sync_directories

여러 모드를 지원하는 고급 디렉토리 동기화

고급 편집 도구

도구

설명

fast_edit_file

여러 모드를 지원하는 정밀한 라인 기반 파일 편집

fast_edit_block

정확한 문자열 일치를 통한 안전한 블록 편집

fast_edit_blocks

여러 정밀한 변경을 위한 배치 블록 편집

fast_edit_multiple_blocks

단일 작업으로 여러 섹션 편집

fast_extract_lines

파일에서 특정 라인 또는 범위 추출

디렉토리 작업

도구

설명

fast_list_directory

페이지네이션을 사용하여 디렉토리 내용 나열

fast_create_directory

재귀적으로 디렉토리 생성

fast_get_directory_tree

디렉토리 트리 구조 가져오기

검색 작업

도구

설명

fast_search_files

이름 또는 내용으로 파일 검색

fast_search_code

ripgrep 통합을 통한 고급 코드 검색

fast_find_large_files

디렉토리 내 대용량 파일 찾기

시스템 작업

도구

설명

fast_get_disk_usage

디스크 사용량 정보 확인

fast_list_allowed_directories

허용된 디렉토리 나열

편집 도구

정밀한 파일 편집

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

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

배지

Listed on Spark

저장소

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