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

1回の操作で複数のセクションを編集

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 - バッチ編集

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.

バッジ

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