文件系统MCP服务器

基于Node.js实现的模型上下文协议（MCP）服务器，用于文件系统操作。

功能

• 读取/写入文件
• 创建/列出/删除目录
• 移动文件/目录
• 搜索文件
• 获取文件元数据

注意：服务器仅允许在通过参数指定的目录内执行操作。

API

• 资源：file://system：文件系统操作接口
• 工具
  • read_file：读取文件完整内容
    • 输入：path（字符串）
    • 以UTF-8编码读取文件的完整内容
  • read_multiple_files：同时读取多个文件
    • 输入：paths（字符串数组）
    • 读取失败不会终止整个操作
  • write_file：创建新文件或覆盖现有文件（使用时请谨慎）
    • 输入：
      • path（字符串）：文件位置
      • content（字符串）：文件内容
  • edit_file：使用高级模式匹配和格式化进行选择性编辑
    • 功能：
      • 基于行和多行内容匹配
      • 保留缩进的空白字符规范化
      • 正确定位的多个同时编辑
      • 缩进样式检测和保留
      • 带上下文的Git风格差异输出
      • 试运行模式下的更改预览
    • 输入：
      • path（字符串）：要编辑的文件
      • edits（数组）：编辑操作列表
      • oldText（字符串）：要搜索的文本（可以是子字符串）
      • newText（字符串）：要替换的文本
      • dryRun（布尔值）：在不应用更改的情况下预览更改（默认值：false）
    • 返回值：试运行时返回详细的差异和匹配信息，否则应用更改
    • 最佳实践：在应用更改之前，始终先使用试运行模式预览更改
  • create_directory：创建新目录或确保其已存在
    • 输入：path（字符串）
    • 如果需要，会创建父目录
    • 如果目录已存在，则无提示地成功执行
  • list_directory：列出目录内容，并带有[FILE]或[DIR]前缀
    • 输入：path（字符串）
  • move_file：移动或重命名文件和目录
    • 输入：
      • source（字符串）
      • destination（字符串）
    • 如果目标已存在，则操作失败
  • search_files：递归搜索文件/目录
    • 输入：
      • path（字符串）：起始目录
      • pattern（字符串）：搜索模式
      • excludePatterns（字符串数组）：排除任何模式。支持通配符格式。
    • 不区分大小写匹配
    • 返回值：匹配项的完整路径
  • get_file_info：获取详细的文件/目录元数据
    • 输入：path（字符串）
    • 返回值：
      • 大小
      • 创建时间
      • 修改时间
      • 访问时间
      • 类型（文件/目录）
      • 权限
  • list_allowed_directories：列出服务器被允许访问的所有目录
    • 无需输入
    • 返回值：此服务器可以读取/写入的目录