
Filesystem MCP Server

2025.04.04
0
JavaScript文件管理文件管理
Filesystem MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专为 Claude AI 提供文件系统操作功能。它支持多种文件操作,包括读取、写入、创建目录、列出目录内容、移动文件、搜索文件以及获取文件元数据等。该服务通过命令行参数限制可访问的目录,确保操作的安全性。
View on GitHub
Overview
基本能力
产品定位
Filesystem MCP Server 是一个为 Claude AI 设计的文件系统操作服务,提供了一系列文件管理功能,支持在指定目录范围内进行安全的文件操作。
核心功能
- 读取文件:读取文件的完整内容(UTF-8编码)。
- 读取多个文件:同时读取多个文件,单个文件读取失败不会影响其他操作。
- 写入文件:创建新文件或覆盖现有文件内容。
- 创建目录:创建新目录或确保目录存在,自动创建父目录。
- 列出目录内容:列出目录内容,并标记文件和目录。
- 移动文件:移动或重命名文件和目录,目标存在时操作失败。
- 搜索文件:递归搜索文件和目录,支持不区分大小写的匹配。
- 获取文件信息:获取文件或目录的详细元数据(大小、时间戳、类型、权限等)。
- 列出允许目录:列出服务器允许访问的所有目录。
适用场景
- 需要自动化文件操作的 AI 应用开发。
- 在受限目录范围内进行安全的文件管理。
- 批量处理文件或目录的场景。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
- 克隆仓库:
git clone <repository-url>
- 安装依赖:
npm install
- 构建项目:
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": []
}
}
}