使用说明

项目简介

MCP_Filesystem 仓库提供了一系列 Model Context Protocol (MCP) 服务器的参考实现，旨在展示如何为大型语言模型 (LLM) 提供安全可控的工具和数据源访问能力。其中 Filesystem 服务器专注于文件系统的安全操作，允许 LLM 在预先配置的目录范围内执行文件和目录管理任务。

主要功能点

安全的文件操作：允许 LLM 安全地读取、写入和编辑文件，以及创建和列出目录。
可配置的访问控制：通过配置允许访问的目录，限制 LLM 的文件系统操作范围，增强安全性。
多种文件操作工具：提供丰富的文件操作工具，例如：
- 'read_file': 读取文件内容。
- 'write_file': 写入或覆盖文件内容。
- 'edit_file': 编辑文件内容，支持查看变更差异。
- 'create_directory': 创建目录。
- 'list_directory': 列出目录内容。
- 'directory_tree': 以树形结构查看目录。
- 'move_file': 移动或重命名文件。
- 'search_files': 搜索文件。
- 'get_file_info': 获取文件信息。

安装步骤

确保已安装 Node.js 和 npm。

全局安装 MCP Filesystem 服务器：

npm install -g @modelcontextprotocol/server-filesystem

服务器配置

要将 Filesystem 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要配置客户端的配置文件。以下是一个配置示例，以 JSON 格式添加到客户端的配置文件中（通常是 'config.json'）：

{
  "mcpServers": {
    "filesystem": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 node
      "args": [
        "C:\\Users\\USER\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "C:\\Users\\USER\\Desktop" // 允许 LLM 访问的根目录，请替换为实际路径，例如用户桌面
      ],
      "useStdio": true // 使用标准输入输出流进行通信
    }
  },
  "mcpDebugLogging": true // 开启调试日志（可选）
}

配置参数说明：

'server name': 'filesystem' (可自定义，用于在客户端中标识该服务器)
'command': 'node' (执行环境，Node.js)
'args': 启动参数，包括：
- 'C:\Users\USER\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-filesystem\dist\index.js': Filesystem 服务器的入口文件路径，通常在全局安装后位于此位置。
- 'C:\Users\USER\Desktop': 重要：这是指定允许 LLM 访问的根目录。请根据您的需求更改此路径。 LLM 只能访问此目录及其子目录中的文件。
'useStdio': 'true' (指定使用标准输入输出流与客户端通信)

基本使用方法

配置完成后，MCP 客户端将能够识别 Filesystem 服务器提供的工具。您可以通过自然语言指示 LLM 使用这些工具来执行文件系统操作。例如，您可以指示 LLM：

"读取文件 '桌面/example.txt' 的内容" (对应 'read_file' 工具)
"在 '桌面/新建文件夹' 中创建一个名为 'output.txt' 的文件，内容为 'Hello, MCP!'" (对应 'write_file' 和 'create_directory' 工具)
"列出 '桌面/文档' 目录下的所有文件和文件夹" (对应 'list_directory' 工具)

请注意，所有文件操作都将限制在您配置的允许访问的目录及其子目录内，确保操作的安全性。

关键词

使用说明

信息