Ai Yliu Filesystem MCP Server

🚀 文件系統 MCP 服務器

本項目是一個為 Claude AI 提供文件系統操作的模型上下文協議 (MCP) 服務器，能讓用戶方便地對文件系統進行各類操作。

🚀 快速開始

此 MCP 服務器可助力 Claude AI 實現文件系統操作。克隆倉庫、安裝依賴並構建項目後，即可使用命令運行服務器，還能將其添加到 MCP 配置文件中。

✨ 主要特性

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

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

🔒 安全性

服務器僅允許在通過命令行參數指定的目錄內執行操作。

📦 安裝指南

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