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 linter

• ruff_format(paths) - 使用 ruff 格式化文件

命令执行

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

  ⚠️ 安全警告：此工具允许在主机系统上执行任意命令。在允许命令运行之前，请务必检查并验证命令，尤其是在输入源不受信任的情况下。