Filesystem MCP Server
2025.04.13
1
TypeScript文件管理文件管理
Filesystem MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 AI 代理提供强大且平台无关的文件系统操作能力。它允许 AI 代理安全地读取、写入、更新和管理本地文件系统中的文件和目录。该服务采用 TypeScript 开发，具备全面的日志记录、错误处理和安全性措施，适合集成到 AI 工作流中。
View on GitHub
Overview
基本能力
产品定位
Filesystem MCP Server 旨在为 AI 代理提供一个安全、可靠的接口，使其能够与本地文件系统进行交互。它适用于需要文件操作能力的 AI 应用场景。
核心功能
- 文件操作：包括读取、写入、更新、删除、移动和复制文件及目录。
- 目录管理：支持创建、删除和列出目录内容。
- 路径管理：支持设置默认工作目录，用于解析相对路径。
- 安全性：内置路径消毒功能，防止目录遍历攻击。
- 日志和错误处理：提供结构化的日志记录和标准化的错误处理。
适用场景
- AI 代理需要读取或修改本地文件。
- 自动化工作流中需要文件系统操作。
- 需要安全地限制文件系统访问范围的场景。
工具列表
- set_filesystem_default：设置默认工作目录。
- read_file：读取文件内容。
- write_file：写入文件内容。
- update_file：在文件中进行搜索和替换操作。
- list_files：列出目录内容。
- delete_file：删除文件。
- delete_directory：删除目录。
- create_directory：创建目录。
- move_path：移动或重命名文件或目录。
- copy_path：复制文件或目录。
常见问题解答
- 如何限制文件系统访问范围？：通过设置
FS_BASE_DIRECTORY环境变量。 - 如何调整日志级别？：通过设置
LOG_LEVEL环境变量。
使用教程
使用依赖
- Node.js
- npm
安装教程
- 克隆仓库：
bash git clone https://github.com/cyanheads/filesystem-mcp-server.git cd filesystem-mcp-server - 安装依赖：
bash npm install - 构建项目：
bash npm run build
调试方式
- 启动服务器：
bash node dist/index.js - 检查日志文件（默认位于
./logs目录）。