Filesystem MCP Server

Filesystem MCP Server

site icon
2025.04.20 86000
JavaScript文件管理文件管理
Filesystem MCP Server 是一个基于 Node.js 的服务器, 用于文件系统操作。它提供了丰富的文件系统操作功能,包括文件读写、目录创建、文件移动、文件搜索以及获取文件元数据等。该服务器仅允许在通过 `args` 指定的目录内进行操作,确保了操作的安全性。
View on GitHub

Overview

基本能力

产品定位

Filesystem MCP Server 是一个用于文件系统操作的 MCP 服务器,主要用于管理和操作文件系统中的文件和目录。

核心功能

  • 文件读写:支持读取和写入文件内容。
  • 目录操作:支持创建、列出和删除目录。
  • 文件移动:支持移动或重命名文件和目录。
  • 文件搜索:支持递归搜索文件和目录。
  • 文件元数据:支持获取文件和目录的详细元数据。

适用场景

  • 文件管理系统:用于管理和操作文件系统中的文件和目录。
  • 开发工具:用于开发工具中的文件操作功能。
  • 自动化脚本:用于自动化脚本中的文件操作任务。

工具列表

  • read_file:读取文件的完整内容。
  • read_multiple_files:同时读取多个文件。
  • write_file:创建新文件或覆盖现有文件。
  • edit_file:使用高级模式匹配和格式化进行选择性编辑。
  • create_directory:创建新目录或确保目录存在。
  • list_directory:列出目录内容。
  • move_file:移动或重命名文件和目录。
  • search_files:递归搜索文件和目录。
  • get_file_info:获取文件和目录的详细元数据。
  • list_allowed_directories:列出服务器允许访问的所有目录。

常见问题解答

  • Q: 服务器可以访问哪些目录? A: 服务器仅允许访问通过 args 指定的目录。
  • Q: 如何预览文件编辑的更改? A: 使用 dryRun 参数可以预览更改而不应用它们。

使用教程

使用依赖

  • Node.js
  • Docker(可选)

安装教程

Docker 安装

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

NPX 安装

npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /path/to/other/allowed/dir

调试方式

  • 使用 dryRun 参数预览文件编辑的更改。
  • 检查服务器日志以获取操作详情。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。