Filesystem (reference server)とは?
Filesystemは、MCPの運営グループがメインのmodelcontextprotocol/serversリポジトリで今も保守している7つのリファレンスサーバーの一つです。GitHub、Postgres、Slackと違い、アーカイブには移されていません。AIアシスタントに13のツールを与え、ファイルの読み書き、差分出力付きの編集、ディレクトリの作成と一覧、ファイルの移動、パターンによる検索、ファイルのメタデータの読み取りができるようにします。2026年10月19日に公開されたバージョン2.0.0は、2026-07-28のプロトコルと2025年世代のクライアントの両方に対応し、Node.js 24以降が必要です。
アクセスは、コマンドラインで渡す許可ディレクトリに限られます(npx -y @modelcontextprotocol/server-filesystem /path/to/dir)。MCP Rootsに対応した古いクライアントは今も実行時にそれを置き換えられますが、Rootsは2026-07-28の仕様で非推奨です。npmパッケージは2026年10月18日までの1週間で約440,000回ダウンロードされました。
Filesystem (reference server)のインストール方法
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dirFilesystem (reference server)は使う価値があるか?
リファレンスのFilesystemサーバーは、メインのmodelcontextprotocol/serversリポジトリで現役のまま保守されており、2026年10月19日に大きな更新を受けました。バージョン2.0.0は新しい2026-07-28のプロトコルと古い2025年のハンドシェイクの両方を話し、Node.jsの最低バージョンを24に引き上げました。古いマシンの構成はこれで壊れます。週に約440,000回というnpmのダウンロード数は、今もどれだけ多くの構成がこれに頼っているかを示して います。
13のツールが、チャットアプリに欠けている機能を補います。先頭と末尾を指定できるread_text_file、read_media_file、read_multiple_files、write_file、git形式の差分とdryRunのプレビュー付きのedit_file、ディレクトリの一覧とツリー、search_files、move_file、get_file_info、list_allowed_directoriesです。すべての呼び出しは許可ディレクトリと照合され、各ツールには読み取り専用、冪等、破壊的のヒントが付いているため、クライアントは書き込みの前に確認を求められます。削除ツールがないのは賢明な省略です。
新しいプロトコルとともにアクセスモデルが変わりました。クライアントが実行時に許可フォルダを差し替えられるMCP Rootsは2026-07-28の仕様で非推奨となったため、新しいクライアントでは、コマンドラインで指定したディレクトリが許可リストのすべてになります。2.0系ではrootsの扱いも厳しくなり、有効なrootsを含まない更新はフォールバックせずにアクセスを取り消すようになりました。過去の経緯は、最新版を使い続けるべき理由になります。2025年7月には深刻度高のアドバイザリが2件、CVE-2025-53109とCVE-2025-53110が公開され、シンボリックリンクや紛らわしいパスのプレフィックスでサンドボックスを抜け出せることが示されました。これらは0.6.3と2025.7.1で修正されました。
MCPプロジェクトは、これらのサーバーは教材の例であって本番向けの製品ではないとはっきり述べています。write_fileはその場で上書きし、クラッシュに対してアトミックではありません。また、サーバーをホームディレクトリに向けると、そこにあるすべてのドットファイルと鍵をモデルに渡すことになります。READMEに記載 されている、読み取り専用のバインドマウントを使うDockerイメージのほうが安全な方法です。Claude Code、Cursor、Codexにはもっと優れた独自のファイルツールがあるため、このサーバーが本当に活きるのはClaude Desktopと、SDKで作った独自のエージェントです。
真価を発揮する場面
業務用ノートPCでClaude Desktopを使うオペレーションマネージャー
会議メモやレポートのフォルダをアシスタントに読ませ、整理させる
~/Documents/opsのような許可ディレクトリを1つ指定してnpxの設定を追加します。モデルは要約し、move_fileで名前を変え、ファイルを書き直せます。削除ツールはありませんが、write_fileは上書きするため、フォルダは同期またはバックアップされる場所に置いてください。
MCP SDKで文書処理エージェントを作る開発者
ファイルツールを書かずに、サンドボックス化したファイルアクセスをエージェントに与える
作業領域を/projectsの下にバインドマウントし、参照データを読み取り専用でマウントしてmcp/filesystemのDockerイメージを動かします。アノテーション付きの13のツールのおかげで、自分でツールを書いて守る手間が省けます。費用はかかりませんが、プロジェクトは本番向けのサポートを提供していません。
50台のデスクトップ向けにMCPサーバーを承認するセキュリティエンジニア
filesystemサーバーを許可しても安全かを判断する
2.0.0以降を必須にし(0.6.3と2025.7.1より前のバージョンにはサンドボックス脱出のCVEがあります)、許可するのはプロジェクトのフォルダだけにしてホームディレクトリは決して許可せず、読むだけでよいユーザーには読み取り専用のDockerマウントを優先します。
導入前に確認すること
- 導入
- Claude Desktopの設定でnpx -y @modelcontextprotocol/server-filesystem /path/to/dirを使うか、VS Code向けのワンクリックのインストールボタン、またはmcp/filesystemのDockerイメージを使います。npxにはNode.js 24以降が必要です。クライアントを再起動すればすぐにツールが使えます。
- 連携
- ツールは13で、読み取り専用が9つ(read_text_file、read_media_file、read_multiple_files、list_directory、list_directory_with_sizes、directory_tree、search_files、get_file_info、list_allowed_directories)、書き込みを行うものが4つ(create_directory、write_file、edit_file、move_file)です。ローカルのみで、すべてのツールがopenWorldHintをfalseにしています。
- データとプライバシー
- 許可ディレクトリ内のものを、あなたのユーザー権限で何でも読み書きします。クライアントがモデルに送るもの以外は、マシンの外に出ません。Dockerのroマウントでフォルダを読み取り専用にできます。深刻度高のサンドボックス脱出のアドバイザリ2件、CVE-2025-53109とCVE-2025-53110は2025年7月に修正されました。
- 大規模利用時のコスト
- 無料でMITライセンスです。運用上のコストはコンテキストで、毎回のリクエストに13のツール定義が含まれるうえ、大きなフォルダではdirectory_treeやread_multiple_filesの結果がすぐにコンテキストウィンドウを埋めることがあります。
- 制限
- 書き込みはクラッシュに対してアトミックではなく、move_fileは移動先が存在すると失敗し、削除ツールはありません。2026-07-28のクライアントではRootsで許可リストを変更できず、ディレクトリを指定せずに起動したサーバーはすべての呼び出しにエラーを返します。
良い点
- すべての呼び出しで許可ディレクトリを確認する
- ツールのヒントで読み取り専用と破壊的な操作を区別できる
- edit_fileが差分を示し、ドライランに対応する
- MCPプロジェクトが保守し、2026年10月19日に2.0.0を公開
気になる点
- MCPプロジェクト自身がリファレンスであり本番向けではないとしている
- 上書きはクラッシュに対してアトミックではない
- 2.0.0にはNode.js 24以降が必要
- ファイルツールを内蔵したコーディングエージェントでは不要
おすすめの人
1つか2つのローカルフォルダへの管理されたアクセスが必要な、Claude Desktopや独自エージェントのユーザーです。
Filesystem (reference server)の代替
Filesystem (reference server):よくある質問
- Filesystem (reference server)は使う価値があるか?
- チャットアプリに1つのフォルダだけを渡す方法として、今も最もすっきりしています。ただし、MCPプロジェクト自身がこれを教材の例と呼んでいることは覚えておいてください。 評価は5点満点中4.1点です。
- Filesystem (reference server)の料金は?
- 無料のオープンソースです。
- Filesystem (reference server)の欠点は?
- MCPプロジェクト自身がリファレンスであり本番向けではないとしている; 上書きはクラッシュに対してアトミックではない; 2.0.0にはNode.js 24以降が必要; ファイルツールを内蔵したコーディングエージェントでは不要.
- Filesystem (reference server)は誰に向いているか?
- 1つか2つのローカルフォルダへの管理されたアクセスが必要な、Claude Desktopや独自エージェントのユーザーです。
- チームや本番環境でFilesystem (reference server)を使うと費用はいくらか?
- 無料でMITライセンスです。運用上のコストはコンテキストで、毎回のリクエストに13のツール定義が含まれるうえ、大きなフォルダではdirectory_treeやread_multiple_filesの結果がすぐにコンテキストウィンドウを埋めることがあります。
- Filesystem (reference server)は企業データを扱っても安全か?
- 許可ディレクトリ内のものを、あなたのユーザー権限で何でも読み書きします。クライアントがモデルに送るもの以外は、マシンの外に出ません。Dockerのroマウントでフォルダを読み取り専用にできます。深刻度高のサンドボックス脱出のアドバイザリ2件、CVE-2025-53109とCVE-2025-53110は2025年7月に修正されました。
- Filesystem (reference server)の代わりになるものは?
- 当サイトでレビューした中で最も近い代替はGit (reference server) 、 Memory (reference server)です。
回答確認日:2026年10月22日
