Filesystem MCP Server

它做什么

• 读写范围限定在显式允许的目录——其余路径一律拒绝
• 完整工具集：read_file、read_multiple_files、write_file、edit_file、create_directory、list_directory、directory_tree、move、search_files、get_file_info
• directory_tree 与递归搜索，快速摸清陌生仓库结构
• npx 本地 stdio 运行——无 daemon、无网络服务、无账号

什么时候用

本地 agent 工作的默认第一个 MCP server：摸代码库、批量重构、把报告写进目录，或任何需要 Claude 直接操作真实文件的场景。配 git-mcp 一起用，让文件改动有版本兜底。

如何上手

在 .mcp.json 的 mcpServers.filesystem 下加：

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects", "/tmp/claude-scratch"]
}

包名之后的每个参数都是一个允许目录；只有这些路径可达。

注意事项

安全性取决于你的允许清单：把 $HOME 挂进去等于白配，请限定到项目目录（需要写入时再配一个草稿目录）。server 内部没有撤销机制——破坏性写入不可回滚，务必放进版本控制。