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) - 使用 Ruff 格式化文件

命令执行

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

⚠️ 安全警告：此工具允许在主机系统上执行任意命令。如果输入源不可信，请始终检查和验证命令，尤其是在允许运行之前