Fast Filesystem MCP

🚀 Fast Filesystem MCP

Claude Desktop用の高度なファイルシステム操作ツールです。大きなファイルを扱う機能とClaudeに最適化された機能を備えています。

🚀 クイックスタート

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）。これにより、編集中のデータ損失を防ぎます。

新バージョンへの更新

最新バージョンに更新するには、以下の手順に従ってください。

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_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