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 命令并捕获其输出

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