mcp-server-filesystem

MCP 服务器，将 Linux 文件系统操作作为工具暴露给 LLM 代理，基于 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