File System MCP Server

基本能力

产品定位

File System MCP Server 是一个专注于文件系统管理的服务，提供跨平台的文件和目录操作能力。

核心功能

1. 文件操作：
2. 复制、移动、删除文件（支持备份）
3. 读写文件内容
4. 获取文件信息（大小、创建时间、修改时间）
5. 按名称模式搜索文件

6. 创建文件集合

7. 目录操作：

8. 列出目录内容
9. 创建和删除目录
10. 递归列出目录结构

11. 按名称模式搜索目录

12. 系统信息：

13. 获取系统信息（操作系统、CPU、内存、磁盘使用情况）
14. 获取磁盘信息（总空间、已用空间、可用空间）
15. 获取目录信息（文件计数、总大小）

适用场景

• 自动化文件管理任务
• 系统集成中的文件操作
• 跨平台文件系统管理
• 文件集合和组织

工具列表

1. 文件操作工具：
2. copy_file：带备份的文件复制
3. move_file：带备份的文件移动
4. delete_file：带安全检查的文件删除
5. read_file：读取文件内容
6. write_file：写入文件内容
7. get_file_info：获取文件详细信息
8. search_files：按名称模式搜索文件

9. create_collection：创建文件集合

10. 目录操作工具：

11. list_directory：列出目录内容
12. create_directory：创建新目录
13. delete_directory：删除目录
14. list_directory_recursively：以树状格式显示目录结构

15. search_directories：按名称模式搜索目录

16. 系统信息工具：

17. get_system_info：获取系统信息
18. get_disk_info：获取磁盘使用信息
19. get_directory_info：获取目录统计信息

常见问题解答

1. 删除文件功能问题：
2. delete_file 功能在某些情况下可能无法正确删除文件

3. 建议手动验证文件删除或使用替代方法

4. 列出驱动器功能问题：

5. list_drives 功能可能无法正确检测或显示所有可用驱动器

6. 某些驱动器可能缺失或显示错误信息

7. 平台特定限制：

8. Windows 特定功能在 macOS/Linux 上不可用
9. 路径处理在不同平台上可能有所不同
10. 系统信息检索因平台而异

使用教程

使用依赖

pip install -r requirements.txt

安装教程

1. 克隆仓库：

git clone https://github.com/calebmwelsh/file-system-mcp-server.git
cd file-system-mcp-server

1. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

1. 安装依赖：

pip install -r requirements.txt

调试方式

1. 集成到 Claude 的配置示例（Windows）：

{
  "mcpServers": {
    "file-system": {
      "command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python39\\python.exe",
      "args": [
        "C:\\Users\\YourUsername\\Documents/file-system-mcp-server/fs_server.py"
      ]
    }
  }
}

1. 集成到 Claude 的配置示例（macOS/Linux）：

{
  "mcpServers": {
    "file-system": {
      "command": "/usr/local/bin/python3",
      "args": [
        "/Users/YourUsername/Documents/file-system-mcp-server/fs_server.py"
      ]
    }
  }
}

1. 查找 Python 路径：
2. Windows (PowerShell):

(Get-Command python).Source

• Windows (CMD):

where python

• Linux/macOS:

which python

许可证

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