文件系统操作服务

一个为Claude AI提供文件系统操作的MCP服务器,支持读取、写入、搜索等多种文件操作。

  • by ai-yliu
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ai-yliu/filesystem-mcp-server

使用说明

文件系统MCP服务器

为Claude AI提供文件系统操作的模型上下文协议(MCP)服务器。

特性

此MCP服务器提供以下文件系统操作:

  1. read_file:读取文件的完整内容

    • 输入: path (字符串)
    • 读取UTF-8编码的完整文件内容
  2. 读取多个文件:同时读取多个文件

    • 输入: paths (字符串[])
    • 读取失败不会停止整个操作
  3. write_file:创建新文件或覆盖现有文件

    • 输入:
      • path (string):文件位置
      • content (string):文件内容
  4. create_directory:创建新目录或确保其存在

    • 输入: path (字符串)
    • 如果需要,创建父目录
    • 如果目录存在,则自动成功
  5. list_directory:列出带有[FILE]或[DIR]前缀的目录内容

    • 输入: path (字符串)
  6. move_file:移动或重命名文件和目录

    • 输入:
      • source (字符串)
      • destination (字符串)
    • 如果目标存在,则失败
  7. 搜索文件:递归搜索文件/目录

    • 输入:
      • path (string):起始目录
      • pattern (string):搜索模式
    • 不区分大小写的匹配
    • 返回匹配项的完整路径
  8. 获取_文件_信息:获取详细的文件/目录元数据

    • 输入: path (字符串)
    • 退货:
      • 尺寸
      • 创建时间
      • 修改时间
      • 访问时间
      • 类型(文件/目录)
      • 权限
  9. list_allowed_directories:列出服务器允许访问的所有目录

    • 无需输入
    • 返回此服务器可以从中读取/写入的目录

安全

服务器只允许在通过命令行参数指定的目录内进行操作。

安装

  1. 克隆此存储库
  2. 安装依赖项: npm install
  3. 构建项目: npm run build

用法

使用一个或多个允许的目录运行服务器:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

MCP配置

将服务器添加到MCP配置文件中:

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

许可证

国际协调委员会