File System MCP Server
2025.04.04
0
Python文件系统管理自动化工具系统集成文件管理
File System MCP Server 是一个基于 FastMCP 构建的强大文件系统管理服务器，提供了一套全面的文件和目录操作工具。该服务器通过结构化 API 执行各种文件系统操作，非常适合自动化以及与其他系统集成。
View on GitHub
Overview
基本能力
产品定位
File System MCP Server 是一个专注于文件系统管理的服务，提供跨平台的文件和目录操作能力，支持自动化任务和系统集成。
核心功能
- 文件操作：
- 复制、移动、删除文件（支持备份）
- 读取和写入文件内容
- 获取文件信息（大小、创建时间、修改时间）
- 按名称模式搜索文件
-
创建文件集合
-
目录操作：
- 列出目录内容
- 创建和删除目录
- 递归列出目录结构
-
按名称模式搜索目录
-
系统信息：
- 获取系统信息（OS、CPU、内存、磁盘使用情况）
- 获取磁盘信息（总空间、已用空间、可用空间）
- 获取目录统计信息
适用场景
- 自动化文件管理任务
- 系统集成中的文件操作
- 跨平台文件系统管理
- 文件集合和组织
工具列表
- 文件操作工具：
copy_file：复制文件（支持备份）move_file：移动文件（支持备份）delete_file：删除文件（安全检查）read_file：读取文件内容write_file：写入文件内容get_file_info：获取文件详细信息search_files：按名称模式搜索文件-
create_collection：创建文件集合 -
目录操作工具：
list_directory：列出目录内容create_directory：创建新目录delete_directory：删除目录list_directory_recursively：以树状格式显示目录结构-
search_directories：按名称模式搜索目录 -
系统信息工具：
get_system_info：获取系统信息get_disk_info：获取磁盘使用信息get_directory_info：获取目录统计信息
常见问题解答
- 删除文件功能问题：
delete_file功能在某些情况下可能无法正确删除文件-
建议用户手动验证文件删除或使用替代方法
-
列出驱动器功能问题：
list_drives功能可能无法正确检测或显示所有可用驱动器-
某些驱动器可能缺失或显示错误信息
-
平台特定限制：
- Windows 特定功能在 macOS/Linux 上不可用
- 路径处理在不同平台上可能有所不同
- 系统信息检索因平台而异
使用教程
使用依赖
- 安装依赖：
pip install -r requirements.txt
安装教程
- 克隆仓库：
git clone https://github.com/calebmwelsh/file-system-mcp-server.git
cd file-system-mcp-server
- 创建并激活虚拟环境：
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
- 安装依赖：
pip install -r requirements.txt
调试方式
- 集成到 Claude 的配置示例：
{
"mcpServers": {
"file-system": {
"command": "/absolute/path/to/python",
"args": [
"/absolute/path/to/file-system-mcp-server/fs_server.py"
]
}
}
}
- 查找 Python 路径：
- Windows (PowerShell):
(Get-Command python).Source
- Windows (Command Prompt/Terminal):
where python
- Linux/macOS (Terminal):
which python