MCP File System Server

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

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