Filesystem MCP Server

Filesystem MCP Server

site icon
2025.03.06 200
Go文件管理文件管理
Filesystem MCP Server 是一个基于 Go 语言实现的 Model Context Protocol (MCP) 服务器,专注于文件系统操作。它提供了一系列功能,包括文件的读写、目录的创建、列出和删除、文件的移动、文件搜索以及获取文件元数据等。该服务器仅允许在通过 `args` 指定的目录内进行操作,确保了操作的安全性。
View on GitHub

Overview

基本能力

产品定位

Filesystem MCP Server 是一个专注于文件系统操作的 MCP 服务器,旨在提供高效、安全的文件管理功能。

核心功能

  • 文件的读写操作
  • 目录的创建、列出和删除
  • 文件的移动和重命名
  • 文件搜索
  • 获取文件元数据
  • 列出服务器允许访问的目录

适用场景

  • 需要自动化文件管理的场景
  • 需要批量处理文件的场景
  • 需要安全限制文件操作范围的场景

工具列表

  • read_file: 读取文件的完整内容,支持 UTF-8 编码。
  • read_multiple_files: 同时读取多个文件,即使部分文件读取失败也不会中断整个操作。
  • write_file: 创建新文件或覆盖现有文件。
  • create_directory: 创建新目录或确保目录存在。
  • list_directory: 列出目录内容,并标记文件和目录。
  • move_file: 移动或重命名文件和目录。
  • search_files: 递归搜索文件和目录,支持不区分大小写的匹配。
  • get_file_info: 获取文件或目录的详细元数据。
  • list_allowed_directories: 列出服务器允许访问的所有目录。

常见问题解答

  • Q: 服务器可以访问哪些目录? A: 服务器仅允许在通过 args 指定的目录内进行操作。
  • Q: 如何安装服务器? A: 使用 go install github.com/mark3labs/mcp-filesystem-server 命令安装。

使用教程

使用依赖

  • 需要安装 Go 语言环境。

安装教程

go install github.com/mark3labs/mcp-filesystem-server

配置教程

将以下内容添加到 claude_desktop_config.json 文件中:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": [
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

调试方式

安装完成后,可以通过运行服务器并检查日志来进行调试。

许可证

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