mcp-server-fs

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

⚠️ 重要提示

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