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: 응답에서 오류 메시지를 숨깁니다.
참고: Claude Desktop에서 JSON 파싱 오류를 방지하기 위해 디버그 출력은 기본적으로 자동으로 억제됩니다.
Related MCP server: Code Buddy
새 버전 업데이트
최신 버전으로 업데이트하려면 다음 단계를 따르세요.
이전 버전 제거
npm uninstall -g fast-filesystem-mcp캐시 및 종속성 정리
npm cache clean --force pnpm store prune최신 버전 설치
npm install -g fast-filesystem-mcp설치 확인
npm list -g fast-filesystem-mcp fast-filesystem-mcp --version
기능
핵심 파일 작업
빠른 파일 읽기/쓰기: 청크 지원을 통해 Claude Desktop에 최적화됨
순차 읽기: 연속 토큰 지원을 통해 대용량 파일을 완전히 읽음
대용량 파일 처리: 모든 크기의 파일에 대한 스트림 기반 쓰기
디렉토리 작업: 포괄적인 디렉토리 나열, 생성 및 관리
파일 검색: 필터링을 포함한 이름 및 내용 기반 파일 검색
고급 기능
페이지네이션 지원: 대용량 디렉토리를 효율적으로 처리
청크 읽기: 대용량 파일을 관리 가능한 단위로 읽기
스트리밍 쓰기: 대용량 파일에 대한 메모리 효율적인 쓰기
백업 및 복구: 자동 백업 생성 및 오류 복구
재시도 로직: 안정적인 작업을 위한 내장 재시도 메커니즘
성능 최적화
Claude 최적화: Claude에 최적화된 응답 크기 및 형식
메모리 효율성: 스트리밍 작업을 통해 메모리 오버플로우 방지
스마트 제외: 시스템 파일 및 디렉토리를 자동으로 제외
진행 상황 추적: 대규모 작업에 대한 실시간 진행 상황 모니터링
사용 가능한 도구
파일 작업
도구 | 설명 |
| 청크 지원을 통해 파일 읽기 |
| 순차 읽기 지원을 통해 여러 파일을 동시에 읽기 |
| 파일 쓰기 또는 수정 |
| 대용량 파일을 위한 스트림 기반 쓰기 |
| 상세 파일 정보 가져오기 |
복합 파일 관리
도구 | 설명 |
| 고급 옵션을 사용하여 파일 및 디렉토리 복사 |
| 파일 및 디렉토리를 안전하게 이동/이름 변경 |
| 보호 기능을 사용하여 파일 및 디렉토리 삭제 |
| 여러 파일 작업을 순차적으로 실행 |
아카이브 관리
도구 | 설명 |
| 압축 아카이브 생성 (tar, tar.gz, tar.bz2) |
| 옵션을 사용하여 압축 아카이브 추출 |
디렉토리 동기화
도구 | 설명 |
| 여러 모드를 지원하는 고급 디렉토리 동기화 |
고급 편집 도구
도구 | 설명 |
| 여러 모드를 지원하는 정밀한 라인 기반 파일 편집 |
| 정확한 문자열 일치를 통한 안전한 블록 편집 |
| 여러 정밀한 변경을 위한 배치 블록 편집 |
| 단일 작업으로 여러 섹션 편집 |
| 파일에서 특정 라인 또는 범위 추출 |
디렉토리 작업
도구 | 설명 |
| 페이지네이션을 사용하여 디렉토리 내용 나열 |
| 재귀적으로 디렉토리 생성 |
| 디렉토리 트리 구조 가져오기 |
검색 작업
도구 | 설명 |
| 이름 또는 내용으로 파일 검색 |
| ripgrep 통합을 통한 고급 코드 검색 |
| 디렉토리 내 대용량 파일 찾기 |
시스템 작업
도구 | 설명 |
| 디스크 사용량 정보 확인 |
| 허용된 디렉토리 나열 |
편집 도구
정밀한 파일 편집
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.
배지
저장소
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