文件系统 MCP 服务器

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

功能特性

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

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

   • 输入: path (字符串)
   • 使用 UTF-8 编码读取完整的文件内容

2. read_multiple_files: 同时读取多个文件

   • 输入: paths (字符串数组)
   • 读取失败不会停止整个操作

3. write_file: 创建新文件或覆盖现有文件

   • 输入:
     • path (字符串): 文件路径
     • content (字符串): 文件内容

4. create_directory: 创建新目录或确保目录存在

   • 输入: path (字符串)
   • 如果需要，创建父目录
   • 如果目录已存在，则静默成功

5. list_directory: 列出目录内容，带有 [FILE] 或 [DIR] 前缀

   • 输入: path (字符串)

6. move_file: 移动或重命名文件和目录

   • 输入:
     • source (字符串)
     • destination (字符串)
   • 如果目标已存在，则失败

7. search_files: 递归搜索文件/目录

   • 输入:
     • path (字符串): 起始目录
     • pattern (字符串): 搜索模式
   • 不区分大小写匹配
   • 返回匹配项的完整路径

8. get_file_info: 获取详细的文件/目录元数据

   • 输入: 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": []
    }
  }
}

许可证

ISC