🚀 文件系统服务器
这是一个基于FastMCP框架构建的文件系统管理服务器，能提供全面的文件和目录操作功能，像复制、移动、删除文件等，还支持获取系统信息。目前在Windows平台上功能最为完善。
🚀 快速开始
克隆仓库
git clone https://github.com/yourusername/file-system-server.git
cd file-system-server
安装依赖项
pip install -r requirements.txt
配置Claude桌面设置
根据示例修改claude_desktop_config.json以指向正确的Python解释器和服务器文件路径。
✨ 主要特性
- 全面的文件和目录操作：提供丰富的文件和目录操作功能，如复制、移动、删除等。
- 系统信息获取：支持获取系统基本信息和磁盘使用情况。
- 多平台支持：在Windows平台上功能完整，在macOS/Linux上支持基本功能。
- 安全保障：包含路径验证，破坏性操作前创建备份文件，严格限制系统信息访问权限。
📦 安装指南
依赖项安装
pip install -r requirements.txt
💻 使用示例
基础用法
# 以下为使用文件操作功能的示例代码
from fs_server import copy_file, move_file, delete_file
# 复制文件
copy_file('source_file.txt', 'destination_file.txt', backup=True)
# 移动文件
move_file('old_location.txt', 'new_location.txt', backup=True)
# 删除文件
delete_file('file_to_delete.txt')
高级用法
# 以下为获取系统信息的示例代码
from fs_server import get_system_info, get_disk_info
# 获取系统基本信息
system_info = get_system_info()
print(system_info)
# 查询磁盘使用情况
disk_info = get_disk_info()
print(disk_info)
📚 详细文档
项目结构
file-system-server/
├── fs_server.py # 主要实现文件系统服务
├── windows_utils.py # Windows平台特定的功能模块
├── requirements.txt # 依赖项列表
└── claude_desktop_config.json # Claude桌面配置示例
平台支持
- Windows：完整功能支持，包括驱动器列表、特殊文件夹访问和系统信息。
- macOS/Linux：仅支持基本功能如文件操作和目录管理。
功能模块
文件操作
copy_file：复制文件，可选备份。move_file：移动文件，可选备份。delete_file：安全删除文件。read_file：读取文件内容。write_file：写入文件内容。get_file_info：获取文件详细信息。search_files：按名称搜索文件。
目录操作
list_directory：列出目录内容。create_directory：创建新目录。delete_directory：删除目录。list_directory_recursively：递归显示目录结构。search_directories：按名称搜索目录。
系统信息
get_system_info：获取系统基本信息。get_disk_info：查询磁盘使用情况。
🔧 技术细节
该项目基于FastMCP框架构建，在Windows平台上能充分利用windows_utils.py模块实现特定功能，而在macOS/Linux上则主要聚焦于基本的文件和目录操作。所有文件操作都包含路径验证，以确保操作的安全性，同时在进行破坏性操作前会创建备份文件。
📄 许可证
本项目遵循MIT License协议，具体见LICENSE文件。
⚠️ 已知问题
- 删除文件功能：可能无法正确删除某些文件，建议手动验证。
- 列出驱动器功能：可能检测不到所有可用驱动器或显示错误信息。
⚠️ 安全注意事项
- 所有文件操作均包含路径验证。
- 破坏性操作前创建备份文件。
- 严格限制对系统信息的访问权限。
👥 贡献指南
- ** Fork 仓库**。
- ** 创建功能分支**。
- ** 提交更改**。
- ** 推送到分支**。
- ** 提出Pull Request**。