Filesystem MCP Server

Filesystem MCP Server

site icon
2025.04.04 0
JavaScript文件管理文件管理
Filesystem MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专为 Claude AI 提供文件系统操作功能。它支持多种文件操作,包括读取、写入、创建目录、列出目录内容、移动文件、搜索文件以及获取文件元数据等。该服务通过命令行参数限制可访问的目录,确保操作的安全性。
View on GitHub

Overview

基本能力

产品定位

Filesystem MCP Server 是一个为 Claude AI 设计的文件系统操作服务,提供了一系列文件管理功能,支持在指定目录范围内进行安全的文件操作。

核心功能

  1. 读取文件:读取文件的完整内容(UTF-8编码)。
  2. 读取多个文件:同时读取多个文件,单个文件读取失败不会影响其他操作。
  3. 写入文件:创建新文件或覆盖现有文件内容。
  4. 创建目录:创建新目录或确保目录存在,自动创建父目录。
  5. 列出目录内容:列出目录内容,并标记文件和目录。
  6. 移动文件:移动或重命名文件和目录,目标存在时操作失败。
  7. 搜索文件:递归搜索文件和目录,支持不区分大小写的匹配。
  8. 获取文件信息:获取文件或目录的详细元数据(大小、时间戳、类型、权限等)。
  9. 列出允许目录:列出服务器允许访问的所有目录。

适用场景

  • 需要自动化文件操作的 AI 应用开发。
  • 在受限目录范围内进行安全的文件管理。
  • 批量处理文件或目录的场景。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。

安装教程

  1. 克隆仓库:git clone <repository-url>
  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 开源许可条款。