filesystem-mcp-server

概述

Filesystem MCP Server 为 AI 代理提供了一个全面的文件系统操作接口，包括读取、写入、更新和管理文件及目录。它实现了平台无关的文件功能，具有高级搜索/替换和目录树遍历特性。该服务器基于 TypeScript 构建，采用生产就绪的架构，通过路径清理、HTTP 传输的 JWT 认证和健壮的错误处理来强调安全性。它支持 STDIO 用于直接进程通信和用于网络交互的 HTTP（具有流功能）。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• set_filesystem_default

  Sets a default absolute path for the current session to resolve relative paths.

  试试:Set the default working directory to /home/user/documents试试:Set project root to ./my-project
• read_file

  Reads the entire content of a specified file as UTF-8 text.

  试试:Read the content of config.json试试:Show me what's in the README.md file
• write_file

  Writes content to a specified file, creating it if it doesn't exist.

  试试:Create a new file with the content 'Hello, World!' called greetings.txt试试:Overwrite the existing notes.md file with updated content
• update_file

  Performs search-and-replace operations within an existing file.

  试试:Replace all occurrences of 'TODO' with 'DONE' in tasklist.txt试试:Use regex to find version numbers and update them
• list_files

  Lists files and directories within a specified path.

  试试:Show all files in the current directory试试:List all files recursively in the src folder
• delete_file

  Permanently removes a specific file.

  试试:Delete the temporary backup file试试:Remove old_log.txt from the logs directory
• delete_directory

  Permanently removes a directory and optionally its contents.

  试试:Delete the empty temp folder试试:Remove the build directory and all its contents
• create_directory

  Creates a new directory at the specified path.

  试试:Create a new directory called assets试试:Make nested directories like src/components/utils

可对比工具

安装

git clone https://github.com/cyanheads/filesystem-mcp-server.git
cd filesystem-mcp-server

npm install

npm run build

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["/path/to/filesystem-mcp-server/dist/index.js"],
      "env": {
        "FS_BASE_DIRECTORY": "/safe/workspace",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

FAQ

如何将文件系统访问限制在特定目录？

设置 FS_BASE_DIRECTORY 环境变量为绝对路径。所有文件系统操作将被限制在此目录及其子目录中。

这个服务器是否支持 STDIO 和 HTTP 传输？

是的，您可以通过设置 MCP_TRANSPORT_TYPE 环境变量将服务器配置为使用 STDIO（默认）或 HTTP 传输。

filesystem-mcp-server 对比