mcp-server-filesystem

Linux ファイルシステム操作を LLM エージェント向けのツールとして公開する MCP サーバーで、FastMCP で構築されています。mcprack MCP プロキシ/カタログツール用の軽量で依存関係の少ないテストサーバーとして設計されています。

設定

資格情報は不要です。すべての設定は環境変数を介して行われ、起動時に一度だけ読み取られます。

ツールに与えられたすべてのパスは FS_ROOT に対して解決され、.. やシンボリックリンクを介してそこから逃げ出そうとする場合は拒否されます。これはアプリケーションレベルの境界であり、堅牢なサンドボックスではありません（chroot/マウント名前空間はありません）。

Related MCP server: ab_mcp

ツール

読み取り専用: list_dir、read_file、stat、exists、glob_search。

変更（FS_READONLY=false が必要）: write_file、mkdir、delete、move、copy。

使用方法

推奨 — VitexSoftware リポジトリの Debian パッケージ

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main backports" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install mcp-server-filesystem

backports コンポーネントは必須であり、任意ではありません。python3-mcp（python3-fastmcp の依存関係）は python3-jsonschema >= 4.20.0 を必要としますが、これは Debian trixie が main で提供しているバージョンよりも新しいため、backports でのみ利用可能です。これがないと、apt install は python3-jsonschema に関する依存関係未解決エラーで失敗します。

これにより、python3-fastmcp と mcp-server-filesystem が一度にインストールされます。

代替 — pip

pip install -e .
export FS_ROOT=/path/to/sandbox
mcp-server-filesystem

mcprack 統合

このサーバーを mcprack に登録するには、次のようにします:

• コマンド: mcp-server-filesystem

• 環境変数: FS_ROOT=/path/to/sandbox、FS_READONLY=false（書き込みが必要な場合）

mcprack はこれを stdio サブプロセスとして起動し、ユーザーごとに HTTP 経由でプロキシします。

開発

pytest