File System MCP Server

🚀 文件系統 MCP 服務器

文件系統 MCP 服務器是基於 FastMCP 構建的現代化文件管理系統。它具備豐富的文件與目錄操作功能，能滿足常見的文件管理需求。同時，系統信息部分還可提供計算機硬件、存儲設備及目錄統計等信息。

🚀 快速開始

依賴項安裝

安裝所需的 Python 包，在終端中執行以下命令：

pip install -r requirements.txt

配置設置

1. 配置 Claude
   • 編輯 claude_desktop_config.json 文件。
   • 添加以下內容：

   {
     "file_system_tools": {
       "command": "/usr/bin/python3",
       "args": [
         "/path/to/fs_server.py"
       ]
     }
   }
   

   • 保存文件並重啟 Claude。

✨ 主要特性

• 豐富的文件和目錄操作：支持複製、移動、刪除文件，讀取和寫入文件內容，獲取文件信息、搜索文件，創建和刪除目錄，列出目錄內容等功能。
• 多平臺支持：支持 Windows、macOS 和 Linux 系統。
• 詳細的系統信息：可提供計算機硬件、存儲設備和目錄統計信息。
• 完善的錯誤處理：所有操作均帶有詳細的錯誤捕獲和日誌記錄機制，提供統一的異常處理接口。
• 安全保障：文件操作默認啟用路徑驗證功能，系統信息檢索經過嚴格的安全審查。

📦 安裝指南

安裝 Python 包

pip install -r requirements.txt

💻 使用示例

文件操作

• 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：獲取目錄統計信息。

📚 詳細文檔

平臺支持

Windows

• 支持所有 Windows 操作系統版本。
• 提供完整的文件和目錄操作功能。
• 支持驅動器列表顯示和路徑處理。

macOS/Linux

• 支持 macOS 和 Linux 系統。
• 提供基本的文件和目錄操作功能。
• 部分與平臺相關的功能可能受限。

未來計劃

功能開發路線圖

1. 第一階段：基本的跨平臺兼容性改進

   • 完善文件路徑處理邏輯。
   • 提高系統信息檢索的安全性和準確性。
   • 修復已知問題，如文件刪除失敗和驅動器列表不完整的問題。

2. 第二階段：增強功能開發

   • 實現平臺間的統一錯誤處理機制。
   • 增加對更多文件操作的路徑驗證。
   • 開發新的系統信息檢索接口。

3. 第三階段：擴展功能實現

   • 引入驅動器映射和網絡共享支持（適用於 Windows）。
   • 增強目錄樹結構顯示功能。
   • 實現更高級的文件搜索算法。

項目結構

- README.md：項目介紹和使用說明
- LICENSE：MIT 許可證
- requirements.txt：Python 依賴項列表
- fs_server.py：主服務器文件
- schemas：Pydantic 數據驗證模型
- tools：功能實現工具模塊

🔧 技術細節

錯誤處理

• 所有文件和目錄操作均帶有詳細的錯誤捕獲和日誌記錄機制。
• 提供統一的異常處理接口，確保用戶能夠準確獲取錯誤信息。

安全性

• 文件操作默認啟用路徑驗證功能，防止惡意路徑注入攻擊。
• 系統信息檢索經過嚴格的安全審查，確保不會洩露敏感信息。

📄 許可證

本項目遵循 MIT 許可證協議。請在使用和分發時遵守相關條款。

⚠️ 重要提示

已知問題

1. 文件刪除功能

   • delete_file 函數在某些情況下可能無法正常工作，建議手動驗證或使用其他方法進行刪除。

2. 驅動器列表功能

   • list_drives 函數可能無法正確檢測所有可用驅動器，部分驅動器可能會缺失或顯示錯誤信息。

3. 平臺限制

   • Windows 獨有功能在 macOS/Linux 上不可用。
   • 不同平臺之間的路徑處理和系統信息檢索可能存在差異。