Filesystem

🚀 文件系統 MCP 服務器

這是一個為 Claude AI 提供文件系統操作的 Model Context Protocol (MCP) 服務器，能助力 Claude AI 高效完成各類文件系統相關任務。

🚀 快速開始

使用此文件系統 MCP 服務器，可按以下步驟操作：

1. 克隆此倉庫。
2. 安裝依賴項: npm install。
3. 構建項目: npm run build。
4. 使用以下命令運行服務器：

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

5. 將服務器添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

此 MCP 服務器提供以下豐富的文件系統操作：

1. 讀取文件：讀取文件的全部內容。
   • 輸入: path（字符串）
   • 使用 UTF-8 編碼讀取完整文件內容。
2. 讀取多個文件：同時讀取多個文件。
   • 輸入: paths（字符串數組）
   • 失敗的讀取不會停止整個操作。
3. 寫入文件：創建新文件或覆蓋現有文件。
   • 輸入:
     • path（字符串）：文件位置。
     • content（字符串）：文件內容。
4. 創建目錄：創建新目錄或確保其存在。
   • 輸入: path（字符串）
   • 如果需要，會創建父目錄。
   • 如果目錄已存在則靜默成功。
5. 列出目錄內容：列出目錄內容並帶有 [FILE] 或 [DIR] 前綴。
   • 輸入: path（字符串）
6. 移動文件：移動或重命名文件和目錄。
   • 輸入:
     • source（字符串）
     • destination（字符串）
   • 如果目標存在則失敗。
7. 搜索文件：遞歸搜索文件/目錄。
   • 輸入:
     • path（字符串）：起始目錄。
     • pattern（字符串）：搜索模式。
   • 不區分大小寫匹配。
   • 返回完整的匹配路徑。
8. 獲取文件信息：獲取文件/目錄的詳細元數據。
   • 輸入: path（字符串）
   • 返回:
     • 大小
     • 創建時間
     • 修改時間
     • 訪問時間
     • 類型（文件/目錄）
     • 權限
9. 列出允許的目錄：列出服務器可以訪問的所有目錄。
   • 無需輸入。
   • 返回服務器可以讀取/寫入的目錄。

🔒 安全性

服務器僅允許在通過命令行參數指定的目錄內執行操作，有效保障操作的安全性。

📦 安裝指南

1. 克隆此倉庫。
2. 安裝依賴項: npm install。
3. 構建項目: npm run build。

💻 使用示例

基礎用法

使用以下命令運行服務器：

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

高級用法

將服務器添加到您的 MCP 配置文件中：

{
  "mcpServers": {
    "filesystem-server": {
      "command": "node",
      "args": [
        "/path/to/filesystem-server/build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

📄 許可證

ISC