🚀 文件系统 MCP 服务器

这是一个为 Claude AI 提供文件系统操作的 Model Context Protocol (MCP) 服务器，能助力 Claude AI 高效完成各类文件系统相关任务。

🚀 快速开始

使用此文件系统 MCP 服务器，可按以下步骤操作：

1. 克隆此仓库。
2. 安装依赖项: npm install。
3. 构建项目: npm run build。
4. 使用以下命令运行服务器：

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

5. 将服务器添加到您的 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": []
    }
  }
}

✨ 主要特性

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

1. 读取文件：读取文件的全部内容。
   • 输入: path（字符串）
   • 使用 UTF-8 编码读取完整文件内容。
2. 读取多个文件：同时读取多个文件。
   • 输入: paths（字符串数组）
   • 失败的读取不会停止整个操作。
3. 写入文件：创建新文件或覆盖现有文件。
   • 输入:
     • path（字符串）：文件位置。
     • content（字符串）：文件内容。
4. 创建目录：创建新目录或确保其存在。
   • 输入: path（字符串）
   • 如果需要，会创建父目录。
   • 如果目录已存在则静默成功。
5. 列出目录内容：列出目录内容并带有 [FILE] 或 [DIR] 前缀。
   • 输入: path（字符串）
6. 移动文件：移动或重命名文件和目录。
   • 输入:
     • source（字符串）
     • destination（字符串）
   • 如果目标存在则失败。
7. 搜索文件：递归搜索文件/目录。
   • 输入:
     • path（字符串）：起始目录。
     • pattern（字符串）：搜索模式。
   • 不区分大小写匹配。
   • 返回完整的匹配路径。
8. 获取文件信息：获取文件/目录的详细元数据。
   • 输入: path（字符串）
   • 返回:
     • 大小
     • 创建时间
     • 修改时间
     • 访问时间
     • 类型（文件/目录）
     • 权限
9. 列出允许的目录：列出服务器可以访问的所有目录。
   • 无需输入。
   • 返回服务器可以读取/写入的目录。

🔒 安全性

服务器仅允许在通过命令行参数指定的目录内执行操作，有效保障操作的安全性。

📦 安装指南

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

💻 使用示例

基础用法

使用以下命令运行服务器：

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

高级用法

将服务器添加到您的 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