Calebmwelsh File System MCP Server

🚀 文件系統服務器

這是一個基於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文件。

⚠️ 已知問題

• 刪除文件功能：可能無法正確刪除某些文件，建議手動驗證。
• 列出驅動器功能：可能檢測不到所有可用驅動器或顯示錯誤信息。

⚠️ 安全注意事項

• 所有文件操作均包含路徑驗證。
• 破壞性操作前創建備份文件。
• 嚴格限制對系統信息的訪問權限。

👥 貢獻指南

1. ** Fork 倉庫**。
2. ** 創建功能分支**。
3. ** 提交更改**。
4. ** 推送到分支**。
5. ** 提出Pull Request**。