文件系统操作服务

MCP服务器提供文件系统操作,支持导航、读取、写入、分析文件和命令执行。

  • by kvas-it
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 kvas-it/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 linter
  • ruff_format(paths) -使用ruff格式化文件

命令执行

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

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