Filesystem MCP Server SSE

Filesystem MCP 服务 SSE

使用 Node.js 实现的服务器 SSE，为文件系统操作实现 Model Context Protocol（MCP）。

功能

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

注意：服务器只允许在通过 args 指定的目录中执行操作。

API

资源

• file://system：文件系统操作接口

工具

• read_file

  • 读取文件的完整内容
  • 输入：path（string）
  • 使用 UTF-8 编码读取文件的完整内容

• read_multiple_files

  • 同时读取多个文件
  • 输入：paths（string[]）
  • 读取失败不会中止整个操作

• write_file

  • 创建新文件或覆盖现有文件（请谨慎使用）
  • 输入：
    • path（string）：文件位置
    • content（string）：文件内容

• edit_file

  • 使用高级模式匹配和格式处理进行选择性编辑
  • 功能：
    • 按行和跨多行匹配内容
    • 规范化空白并保留缩进
    • 同时执行多个编辑并确保位置正确
    • 检测并保留缩进样式
    • 输出带上下文的 Git 风格差异
    • 使用试运行模式预览更改
  • 输入：
    • path（string）：要编辑的文件
    • edits（array）：编辑操作列表
      • oldText（string）：要搜索的文本（可以是子字符串）
      • newText（string）：要替换成的文本
    • dryRun（boolean）：预览更改但不应用（默认值：false）
  • 试运行时返回详细的差异和匹配信息，否则应用更改
  • 最佳实践：应用更改前，务必先使用 dryRun 预览更改

• create_directory

  • 创建新目录或确保目录存在
  • 输入：path（string）
  • 如有需要，会创建父目录
  • 如果目录已存在，则静默成功

• list_directory

  • 使用 [FILE] 或 [DIR] 前缀列出目录内容
  • 输入：path（string）

• move_file

  • 移动或重命名文件和目录
  • 输入：
    • source（string）
    • destination（string）
  • 如果目标已存在，则操作失败

• search_files

  • 递归搜索文件/目录
  • 输入：
    • path（string）：起始目录
    • pattern（string）：搜索模式
    • excludePatterns（string[]）：要排除的模式。支持 Glob 格式。
  • 不区分大小写
  • 返回匹配项的完整路径

• get_file_info

  • 获取文件/目录的详细元数据
  • 输入：path（string）
  • 返回：
    • 大小
    • 创建时间
    • 修改时间
    • 访问时间
    • 类型（文件/目录）
    • 权限

• list_allowed_directories

  • 列出服务器获准访问的所有目录
  • 无需输入
  • 返回：
    • 此服务器可读写的目录

在 Cherry Stdio Desktop 中使用

注意：可通过将沙盒目录挂载到 /projects，将其提供给服务器。添加 ro 标志会使服务器对该目录具有只读权限。

Docker

注意：默认情况下，所有目录都必须挂载到 /projects。

1. Docker 构建：

docker build -t mcp/filesystem -f Dockerfile .

2. Docker 运行：

docker run -i --mount type=bind,src=type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro -p 3001:3001 mcp/filesystem /projects

3. 配置：

{
  "mcpServers": {
    "file_system": {
      "name": "file_system",
      "baseUrl": "http://ip:3001/sse"
    }
  }
}

本地

1. 构建：

npm install

2. 运行：

node .\dist\index.js C:\Users\User\Desktop\project

允许的目录：C:\Users\User\Desktop\project

3. 配置：

{
  "mcpServers": {
    "file_system": {
      "name": "file_system",
      "baseUrl": "http://127.0.0.1:3001/sse"
    }
  }
}

许可证

此 MCP 服务采用 MIT 许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。