Filesystem MCP Server
2025.03.01
1
JavaScript文件管理文件管理
Filesystem MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门为 Claude AI 提供文件系统操作功能。该服务器支持多种文件操作，包括读取、写入、创建目录、列出目录内容、移动文件、搜索文件以及获取文件元数据等。它通过限制可访问的目录来确保操作的安全性，适用于需要文件系统集成的AI应用场景。
View on GitHub
Overview
基本能力
产品定位
Filesystem MCP Server 是一个专门为 Claude AI 设计的文件系统操作服务，通过 MCP 协议提供安全的文件访问和管理功能。
核心功能
- 文件读取：支持读取单个或多个文件内容。
- 文件写入：创建新文件或覆盖现有文件。
- 目录操作：创建目录、列出目录内容。
- 文件移动：移动或重命名文件和目录。
- 文件搜索：递归搜索文件和目录。
- 文件信息获取：获取文件/目录的详细元数据。
- 权限控制：限制服务器只能访问指定的目录。
适用场景
- AI 应用需要读取或写入本地文件系统。
- 自动化脚本需要管理文件和目录。
- 需要安全地限制文件系统访问权限的场景。
工具列表
read_file：读取文件内容。read_multiple_files：同时读取多个文件。write_file：写入文件内容。create_directory：创建目录。list_directory：列出目录内容。move_file：移动或重命名文件。search_files：递归搜索文件。get_file_info：获取文件元数据。list_allowed_directories：列出允许访问的目录。
常见问题解答
- 如何限制服务器访问的目录？：通过命令行参数指定允许访问的目录。
- 如何处理文件读取失败？：
read_multiple_files操作中，单个文件读取失败不会影响其他文件的读取。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库后，运行以下命令安装依赖：
bash npm install
安装教程
- 克隆仓库。
- 安装依赖：
npm install - 构建项目：
npm run build
调试方式
- 运行服务器：
bash node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2 - 检查服务器日志以确保正常运行。
- 使用 MCP 配置文件测试各功能是否按预期工作。