ファイルシステム MCP サーバー

「ファイルシステム」MCPサーバーは何をする？

ファイルシステム MCP サーバーは、Model Context Protocol（MCP）を通じてローカルファイルシステムへの安全でプログラム的なアクセスを提供します。これにより、AIアシスタントや他のクライアントがサーバー上のファイルやディレクトリを操作できるようになり、読み書き・コピー・移動・検索・編集、ディレクトリ管理などの操作が可能です。開発ワークフローを強化するために設計されており、許可ディレクトリやパス検証など厳格なセキュリティ制御のもとでファイル操作APIを公開します。これにより、AIエージェントによるファイル管理タスクとの橋渡しが実現し、コードベース探索、自動ファイル編集、バッチ検索置換など、細やかな制御と堅牢な安全対策のもとでさまざまなユースケースをサポートします。

プロンプト一覧

リポジトリのドキュメントやファイルには明示的なプロンプトテンプレートは記載されていません。

リソース一覧

リポジトリには明示的なMCP「リソース」は記載されていません。サーバーはファイルシステム操作をツールとして公開することに特化しています。

ツール一覧

• read_file
  ファイルシステムからファイルの内容をすべて読み取ります。
• read_multiple_files
  複数のファイル内容を一度に読み取ります。
• write_file
  新しいファイルの作成や既存ファイルの上書きを行います。
• copy_file
  ファイルやディレクトリをコピーします。
• move_file
  ファイルやディレクトリの移動やリネームを行います。
• delete_file
  ファイルやディレクトリをファイルシステムから削除します（再帰削除オプションあり）。
• modify_file
  文字列一致または正規表現でファイル内テキストを検索・置換します。
• list_directory
  指定パス内のすべてのファイルおよびディレクトリを一覧表示します。
• create_directory
  新しいディレクトリの作成や既存ディレクトリの存在確認を行います。
• tree
  ディレクトリ構造を階層的なJSON形式で返します。
• search_files
  パターンに一致するファイルやディレクトリを再帰的に検索します。
• search_within_files
  ディレクトリツリー内のファイル内容からテキストを検索します。
• get_file_info
  ファイルやディレクトリの詳細なメタデータを取得します。
• list_allowed_directories
  サーバーがアクセス許可されたディレクトリ一覧を返します。

このMCPサーバーのユースケース

• 自動コードベース探索
  開発者やAIアシスタントがプロジェクトフォルダを素早く探索し、ファイル一覧やコードパターン、ファイルタイプ検索を行えます。
• バッチファイル編集
  modify_fileツールで複数ファイルにわたるテキストやコードの一括検索・置換（テキストまたは正規表現）が可能です。
• 安全なファイル管理
  指定ディレクトリ内での読み書き・移動・コピー・削除を制御された環境で安全に実行でき、自動化にも最適です。
• コンテンツ検索・発見
  特定パターンや内容に一致するファイルやディレクトリを素早く特定でき、ドキュメント整理やリファクタ、リサーチ作業を支援します。
• 自動バックアップや整理
  copy_file, move_file, treeツールを使い、バックアップやプロジェクト構造の再編成、ディレクトリレイアウトのミラーリングを自動化できます。

セットアップ手順

Windsurf

1. Goをインストールし、MCPファイルシステムサーバーのバイナリを用意します。

2. Windsurfの設定ファイルを開きます。

3. 以下のJSONスニペットでMCPサーバーを追加します:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. 設定を保存してWindsurfを再起動します。

5. 「filesystem」MCPサーバーがMCPインテグレーションに表示されていることを確認します。

APIキーの安全な管理（環境変数例）

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Claude

1. ファイルシステム MCP サーバーをダウンロードしてインストールします。

2. MCPインテグレーション用のClaude設定ファイルを探します。

3. 以下のようにサーバー登録を挿入します:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. 保存してClaudeを再起動します。

5. ファイルシステム MCP サーバーがアクティブであることを確認します。

Cursor

1. Goまたはリリースからサーバーバイナリをインストールします。

2. CursorのMCP設定や設定ファイルを開きます。

3. ファイルシステム MCP サーバーを追加します:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. 保存してCursorを再起動します。

5. list_directoryなどのツールで統合をテストします。

Cline

1. ファイルシステム MCP サーバーのバイナリをビルドまたはダウンロードします。

2. ClineのMCPインテグレーション設定を行います。

3. 以下を追加します:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. 設定を保存してClineを再起動します。

5. read_file操作などで動作を確認してください。

APIキーの安全な管理について

機密データには環境変数を利用しましょう。例:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

フロー内でこのMCPを使う方法

FlowHuntでのMCP利用方法

FlowHuntワークフローにMCPサーバーを統合するには、MCPコンポーネントをフローに追加し、AIエージェントと接続します:

MCPコンポーネントをクリックして設定パネルを開き、system MCP設定セクションに下記JSON形式でMCPサーバー詳細を入力します:

{
  "filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントはこのMCPをツールとして利用でき、すべての機能にアクセス可能となります。 “filesystem"を実際のMCPサーバー名に、URLをご自身のMCPサーバーURLに変更してください。

概要

| ルート（Roots）サポート | ✅ | list_allowed_directoriesで許可ルートを公開 |

総評

ファイルシステム MCP サーバーは、安全かつ細やかなファイルシステムアクセスに特化した堅牢なサーバーであり、MCPツールとして豊富なファイル・ディレクトリ操作を提供します。ドキュメントも明快で、AI主導開発ワークフローに実践的なプリミティブを多数備えています。一方、プロンプトテンプレートや明示的なMCPリソースの記載はなく、サンプリング等の高度なMCP機能も言及されていません。許可ルートはlist_allowed_directoriesツールで対応しています。

スコア: 8/10 — 優れたツール群・ドキュメントを備え、プロンプトやリソース面の細部にやや不足あり。

MCPスコア