← 返回目录
M

mcp-server-filesystem

官方
为 MCP 提供受限的文件系统访问能力
GitHub 源仓库 ↗
★ 38.2k Stars 分类 · 文件系统 非常热门
46FMRS · D
可靠性
8/20
安全与权限
8/20
维护活跃度
13/20
文档质量
7/20
安装易用性
10/20

来源明确表明这是一个 active 的文件系统 MCP 服务器,支持三种传输方式,并要求配置允许访问的目录;来源未提供具体工具名称、客户端兼容性或身份验证信息。

查看 FMRS 评分方法 →

这是 UI-TARS-desktop 仓库中的文件系统 MCP 服务器,允许通过配置的目录范围执行文件操作。清单显示其状态为 active,版本为 1.0.0,并支持 stdio、SSE 和 Streamable HTTP 传输。

工具能力

暂未整理工具清单。

安装接入

从 npm registry 使用 @agent-infra/mcp-server-filesystem,并提供必填参数 allowed-directories,指定允许进行文件操作的目录。SSE 和 Streamable HTTP 模式还需要提供端口号,默认端口为 8089。

选型与风险

适合谁

  • 需要受控本地文件访问的 MCP 客户端
  • 希望明确限制文件操作范围的开发者

不适合谁

  • 需要访问未授权目录的工作流
  • 需要已明确列出工具名称或功能的用户

所需权限

  • 必须授予服务器对 allowed-directories 所列目录的文件操作权限
  • SSE 或 Streamable HTTP 模式需要使用配置的本地端口

风险与副作用

  • allowed-directories 配置过宽可能扩大本地文件暴露或修改范围
  • 通过本地 SSE 或 HTTP 端点连接时,应注意端口和访问范围配置
  • 源材料未说明具体文件工具、身份验证或授权机制

常见排障

  1. 检查是否提供了必填的 allowed-directories 参数
  2. 使用 SSE 或 Streamable HTTP 时检查端口配置,默认值为 8089
  3. 确认客户端使用的传输方式与服务器配置一致
  4. 确认指定目录存在且服务器具有相应文件权限

使用场景

让 MCP 客户端访问指定目录中的文件
为代理工作流提供受目录限制的本地文件操作能力

支持客户端

暂未确认支持的客户端。