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) |
| オプション付きで圧縮アーカイブを解凍 |
ディレクトリ同期
ツール | 説明 |
| 複数のモードを備えた高度なディレクトリ同期 |
高度な編集ツール
ツール | 説明 |
| 複数のモードを備えた正確な行ベースのファイル編集 |
| 正確な文字列一致による安全なブロック編集 |
| 複数の正確な変更のためのバッチブロック編集 |
| 1回の操作で複数のセクションを編集 |
| ファイルから特定の行や範囲を抽出 |
ディレクトリ操作
ツール | 説明 |
| ページネーション付きでディレクトリの内容を一覧表示 |
| 再帰的にディレクトリを作成 |
| ディレクトリツリー構造を取得 |
検索操作
ツール | 説明 |
| 名前またはコンテンツでファイルを検索 |
| 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 - バッチ編集
1回の操作でファイルの複数の箇所を編集します。
{
"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
}
}編集機能
自動バックアップ: 変更前にバックアップを作成
エラーリカバリ: 失敗時にバックアップから復元
行ベースの操作: 特定の行に対する正確な制御
パターンマッチング: 正規表現をサポート
バッチ操作: 1つのトランザクションで複数の編集を実行
コンテキスト抽出: 周辺コンテキストを含めて行を抽出
大容量ファイルの書き込み
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