Filesystem MCP Server

Filesystem MCP Server 是 Model Context Protocol 官方提供的参考实现之一，为 AI 代理提供安全、受控的本地文件系统访问能力。

核心功能

• 安全文件读写：支持文本/二进制文件的读取与写入操作
• 目录管理：目录创建、删除、遍历、重命名
• 文件搜索：按文件名、内容模式搜索文件
• 元数据获取：文件大小、修改时间、权限等属性查询
• 路径白名单：通过 Roots 协议动态配置允许访问的目录，防止越权访问
• 多传输支持：支持 STDIO 和 Streamable HTTP 两种传输方式

适用场景

• AI 代码助手读取和编辑本地项目文件
• 文档处理代理批量读取、转换本地文档
• 项目管理工具分析本地代码仓库结构
• 本地开发环境下的文件自动化操作

安装方式

# 通过 npx 直接运行
npx @modelcontextprotocol/server-filesystem /path/to/allowed/dir

# 或全局安装
npm install -g @modelcontextprotocol/server-filesystem

配置示例（Claude Desktop）

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/projects"]
    }
  }
}

开源地址：https://github.com/modelcontextprotocol/servers （MIT 许可证）