Filesys

🚀 文件系統 MCP 服務器

文件系統 MCP 服務器是一個安全的模型上下文協議（MCP）服務器，它能夠提供受控訪問指定目錄的文件系統操作，保障文件操作的安全性與可控性。

🚀 快速開始

本服務器可通過環境變量控制目錄訪問，且所有文件操作都受限於允許的目錄內。以下是快速使用的步驟：

1. 安裝項目
2. 配置允許訪問的目錄
3. 構建項目
4. 集成到 Claude Desktop（可選）

✨ 主要特性

• 環境變量控制訪問：通過環境變量控制目錄訪問，靈活且安全。
• 操作範圍受限：所有文件操作都被限制在允許的目錄內，防止越權操作。
• 線程安全緩存：線程安全的緩存允許目錄功能，提升性能。
• 空格路徑處理：能夠正確處理包含空格的路徑，避免路徑解析錯誤。

📦 安裝指南

使用以下命令安裝項目：

go get github.com/gomcpgo/filesys

📚 詳細文檔

配置

使用環境變量設置允許目錄：

export MCP_ALLOWED_DIRS="/path1,/path2,/path with spaces/dir3"

工具集

文件讀取

• read_file：讀取單個文件內容
• read_multiple_files：同時讀取多個文件

文件寫入

• write_file：創建或覆蓋文件

目錄操作

• create_directory：創建新目錄
• list_directory：列出目錄內容
• list_allowed_directories：顯示可訪問的目錄

文件管理

• move_file：移動或重命名文件和目錄
• get_file_info：獲取文件元數據
• search_files：遞歸搜索帶有模式匹配的文件

與 Claude Desktop 集成

將以下內容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/filesys",
      "env": {
        "MCP_ALLOWED_DIRS": "/path1,/path2,/path with spaces/dir3"
      }
    }
  }
}

💻 使用示例

基礎用法

讀取文件

{
    "name": "read_file",
    "arguments": {
        "path": "/allowed/path/file.txt"
    }
}

列出目錄內容

{
    "name": "list_directory",
    "arguments": {
        "path": "/allowed/path"
    }
}

🔧 技術細節

安全性

• 操作受限：所有操作受限於允許的目錄，防止越權訪問。
• 攻擊防範：防止路徑遍歷攻擊，保障系統安全。
• 權限驗證：操作前進行權限驗證，確保操作合法。
• 錯誤處理：正確處理錯誤和日誌記錄，方便問題排查。

構建

go build -o bin/filesys cmd/main.go

📄 許可證

本項目採用 MIT License 許可協議。

項目貢獻

歡迎提交拉取請求。請確保：

• 測試通過
• 新功能包含文檔
• 代碼遵循項目風格