Filesys 是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在为大型语言模型（LLM）客户端提供访问本地文件系统的能力。通过 Filesys，LLM 可以安全地列出和读取特定目录下的文件。

主要功能点

• 文件列表: 允许 LLM 列出服务器配置的基准目录下的所有文件。
• 文件读取: 允许 LLM 读取指定文件的内容，支持文本文件。
• 安全访问: 包含目录遍历防护，确保 LLM 只能访问基准目录及其子文件，不能访问系统其他位置。

安装步骤

1. 访问仓库的 Releases 页面 (例如，通过 README 中提供的下载链接)。
2. 下载最新版本的服务器文件。
3. 解压文件到本地目录。
4. 编辑 'config/config.json' 文件，设置 'directory' 参数为你希望服务器允许访问的本地文件夹的绝对路径。
5. 确保你的系统安装了 Python 环境。

服务器配置

Filesys 作为 MCP 服务器，需要由支持 MCP 协议的客户端（如基于 'python-mcp' 的 LLM 应用）启动和连接。客户端在配置 MCP 服务器时，需要提供启动 Filesys 服务器所需的命令和参数。配置信息通常是 JSON 格式，例如：

{
  "server_name": "FileSystemServer",
  "command": "python",
  "args": ["path/to/your/downloaded/filesys/run.py"]
}

这里的 '"server_name"' 是服务器在 MCP 协议中声明的名称，'"command"' 是执行服务器程序的命令，'"args"' 是传递给命令的参数。请将 '"path/to/your/downloaded/filesys/run.py"' 替换为你实际存放 'run.py' 文件的路径。具体的配置方式取决于你使用的 MCP 客户端框架。

基本使用方法

配置并启动 MCP 客户端后，客户端会连接到 Filesys 服务器。LLM 可以通过 MCP 协议向 Filesys 服务器发送请求来访问文件资源：

• 列出文件: LLM 可以请求访问 URI 为 'files://list' 的资源，获取配置目录下的文件列表。
• 读取文件: LLM 可以请求访问 URI 为 'files://read/文件名' 的资源，其中 '文件名' 是要读取的文件名，获取该文件的内容。

具体如何向 LLM 提供这些功能取决于你使用的 MCP 客户端或 LLM 集成框架。