mcp-filesystem-server

Filesystem MCP Server

功能特性

• 文件读写

• 目录的创建、列表展示和删除

• 文件/目录的移动

• 文件搜索

• 获取文件元数据

• 生成目录树结构

API

资源

• file://system：文件系统操作接口

工具

• read_file
• 读取文件的完整内容
• 输入：path (string)
• 使用 UTF-8 编码读取文件内容

• read_multiple_files
• 同时读取多个文件
• 输入：paths (string[])
• 单个文件读取失败不会中断整个操作

• write_file
• 创建新文件或覆盖现有文件（请谨慎使用）
• 输入：
• path (string)：文件路径
• content (string)：文件内容

• create_directory
• 创建新目录或确保目录存在
• 输入：path (string)
• 如果父目录不存在，会自动创建
• 如果目录已存在，操作会静默成功

• list_directory
• 列出目录内容，并以 [FILE] 或 [DIR] 前缀标识文件或目录
• 输入：path (string)

• move_file
• 移动或重命名文件和目录
• 输入：
• source (string)：源路径
• destination (string)：目标路径
• 如果目标路径已存在，操作会失败

• search_files
• 递归搜索文件或目录
• 输入：
• path (string)：起始目录
• pattern (string)：搜索模式
• 支持不区分大小写的匹配
• 返回匹配项的完整路径

• get_file_info
• 获取文件/目录的详细元数据
• 输入：path (string)
• 返回：
• 文件大小
• 创建时间
• 修改时间
• 访问时间
• 类型（文件/目录）
• 权限信息

• tree
• 返回目录结构的层次化 JSON 表示
• 输入：
• path (string)：要遍历的目录（必填）
• depth (number)：最大遍历深度（默认：3）
• follow_symlinks (boolean)：是否跟随符号链接（默认：false）
• 返回格式化的 JSON，包含文件/目录的层次结构
• 包含文件元数据（名称、路径、大小、修改时间）

• list_allowed_directories
• 列出服务器允许访问的所有目录
• 无需输入
• 返回：
• 服务器可以读写操作的目录列表

与 Claude Desktop 集成使用

许可证