filesystem

概述

文件系统 MCP 服务器提供了全面的文件和目录读写操作工具，包括只读和写入功能，以及详细的元数据信息。该服务器最突出的特点是它复杂的目录访问控制系统，既支持命令行配置，也支持通过 MCP Roots 协议进行动态更新，这允许在不重启服务器的情况下灵活调整运行时配置。服务器遵循安全最佳实践，将所有操作限制在明确允许的目录范围内。

试试问 AI

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

• read_text_file

  Read complete contents of a file as text

  试试:Read the contents of my document.txt试试:Show me the first 10 lines of the log file
• read_media_file

  Read an image or audio file and return base64 data

  试试:Display the profile.png image试试:Convert audio.mp3 to base64
• write_file

  Create new file or overwrite existing file

  试试:Create a new file with my notes试试:Overwrite config.json with new settings
• edit_file

  Make selective edits to a file using pattern matching

  试试:Update the version number in package.json试试:Fix typo in README.md
• create_directory

  Create new directory or ensure it exists

  试试:Create a new folder for my project试试:Make sure assets directory exists
• list_directory

  List directory contents with [FILE] or [DIR] prefixes

  试试:Show what's in the current directory试试:List contents of the src folder
• search_files

  Recursively search for files/directories that match patterns

  试试:Find all .js files in the project试试:Search for files named config
• get_file_info

  Get detailed file/directory metadata

  试试:Show me details about this image试试:When was this document last modified
• move_file

  Move or rename files and directories

  试试:Move file.txt to documents folder试试:Rename old_name to new_name
• directory_tree

  Get recursive JSON tree structure of directory contents

  试试:Show me the complete directory structure试试:Export project folder as JSON tree
• list_allowed_directories

  List all directories the server is allowed to access

  试试:Which directories can I access?试试:Show me the allowed paths
• list_directory_with_sizes

  List directory contents with file sizes

  试试:Show directory sizes sorted by size试试:List files with their sizes

可对比工具

安装

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

{
  "mcpServers": {
    "filesystem": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/path/to/allowed/dir,dst=/projects/allowed/dir",
        "mcp/filesystem",
        "/projects"
      ]
    }
  }
}

FAQ

如何限制仅访问特定目录？

您可以在启动服务器时通过命令行参数指定允许访问的目录，或使用 MCP Roots 协议进行动态目录访问控制。服务器仅允许在指定的目录内进行操作。

文件系统服务器可以与 Claude Desktop 一起使用吗？

可以，README 中为 Claude Desktop 提供了具体的配置示例，包括 NPX 和 Docker 部署选项。

如果没有指定目录会发生什么？

如果服务器在没有命令行参数的情况下启动，且客户端不支持 roots 协议（或提供了空的 roots），服务器在初始化时会抛出错误，因为它至少需要一个允许的目录才能运行。

Hacker News 讨论

开发者社区最近的相关讨论。

• Modelcontextprotocol/Servers: Model Context Protocol Servers▲ 1
  帖子 by vinnyglennon · 2025-03-20

filesystem 对比