MCP Filesystem Server

Model Context Protocol 官方文件系统服务器——Agent 安全访问本地文件的标准方案。

功能介绍

MCP Filesystem Server 是 Anthropic 维护的 MCP 官方服务器之一，为 AI Agent 提供受控的本地文件系统访问能力。它的核心设计理念是安全第一——只允许访问白名单目录，防止 Agent 越权读取敏感文件。

提供的 MCP 工具：

• read_file：读取指定文件内容
• read_multiple_files：批量读取多个文件
• write_file：写入文件内容（创建或覆盖）
• edit_file：精确编辑文件（基于行号或文本匹配替换）
• create_directory：创建目录（含中间目录）
• list_directory：列出目录内容（区分文件和目录）
• directory_tree：返回目录树结构（JSON 格式）
• move_file：移动或重命名文件
• search_files：递归搜索文件名匹配模式
• get_file_info：获取文件元数据（大小、修改时间、权限）

安装步骤

在 MCP 客户端中配置

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ]
    }
  }
}

全局安装

npm install -g @modelcontextprotocol/server-filesystem

使用示例

配置完成后，AI Agent 可通过自然语言操作文件：

读取 /project/src/main.py 的内容
列出 /project/src 目录下的所有文件
在 /project/docs 目录下创建 README.md
搜索 /project 中所有 .test.ts 文件
把 /project/config.json 中的 "port": 3000 改为 "port": 8080

⚠️ 安全提示：只允许 Agent 访问工作目录，不要将 ~、/ 等根目录加入白名单。不要将包含密钥、证书的目录开放给 Agent。

GitHub: https://github.com/modelcontextprotocol/servers