MCP 文件系统服务器

提供文件系统操作的MCP服务器。支持导航、读取、写入、分析文件以及执行命令。

工具

文件和目录操作

• ls(path) - 列出目录内容
• cd(path) - 更改工作目录（支持使用~扩展到主目录）
• read_file(path) - 读取文件内容
• write_file(path, content) - 将内容写入文件
• mkdir(path) - 创建目录
• rm(path) - 删除文件或空目录
• rmdir(path) - 递归删除目录及其内容
• cp(src, dst) - 复制文件或目录
• mv(src, dst) - 移动文件或目录

编辑和搜索

• edit_file(path, changes) - 对文件应用多个查找/替换操作，其中changes是一个由(search_text, replace_text)元组组成的列表
• grep(pattern, path) - 在文件中搜索正则表达式模式

分析

• summary(path) - 生成Python (.py) 和 Markdown (.md) 文件的摘要：
  • Python：列出函数和类
  • Markdown：列出标题（以#开头的行）

批量操作

• read_files(paths) - 读取多个文件，返回一个将路径映射到内容的字典
• summarize(paths) - 为多个文件生成摘要，返回一个将路径映射到摘要的字典

项目导航

• work_on(path) - 更改到指定目录，列出其内容，并获取CLAUDE.md中的笔记。 对于在聊天开始时熟悉一个项目非常有用

代码质量

• ruff_check(paths) - 在指定文件上运行ruff代码检查器
• ruff_format(paths) - 使用ruf对文件进行格式化

命令执行

• shell_command(command, args=None, cmdline=None, timeout=30) - 运行shell命令并捕获其输出

  ⚠️ 安全警告：此工具允许在主机系统上执行任意命令。始终检查并验证命令，在允许它们运行之前，特别是当输入源不可信时。