Martinschlott BetterMCPFileServer

🚀 更好MCP文件服務器

BetterMCPFileServer 是一款專門為開發者打造的功能更強大的MCP文件服務器。它提供簡單易用的接口，可用於管理文件和目錄，支持文件的寫入、讀取、編輯、移動、複製、刪除操作，還能搜索文件和目錄。

🚀 快速開始

BetterMCPFileServer 能讓你高效管理文件和目錄。啟動服務器時，你至少需要提供一個別名:路徑對。

✨ 主要特性

• 強大而簡潔：通過6個核心功能處理所有文件操作。
• 虛擬根目錄：通過定義別名:路徑對，將物理路徑映射到虛擬路徑。
• 安全沙盒：嚴格限制訪問權限，確保操作僅限於指定的目錄。
• 靈活搜索：支持Glob模式匹配，幫助您高效定位文件和目錄。

📦 安裝指南

從npm（即將推出）

npm install -g BetterMCPFileServer  # 尚未可用

從源代碼（當前方法）

git clone https://github.com/martinschlott/BetterMCPFileServer.git
cd BetterMCPFileServer
npm install
npm run build
npm link  # 可選，全局使用命令

💻 使用示例

基本使用

啟動服務器時需要至少一個別名:路徑對：

BetterMCPFileServer 別名:目錄 [別名2:目錄2 ...]

示例

# 單個目錄
BetterMCPFileServer code:~/projects

# 多個目錄
BetterMCPFileServer code:~/Development docs:~/Documents/Technical notes:~/Notes

高級配置

創建一個簡單的shell腳本以保持一致的配置：

#!/bin/bash
# start-server.sh
BetterMCPFileServer \
  code:~/Development/MyProjects \
  docs:~/Documents/Technical \
  data:~/Data/Samples \
  config:~/Configuration

基本文件操作

// 讀取文件內容
const 內容 = await readFileContent({ filePath: "projects/README.md" });

// 寫入文件
await writeFile({
  filePath: "projects/notes.txt",
  content: "重要會議筆記。"
});

// 編輯文件
await editFile({
  filePath: "projects/config.json",
  edits: [
    {
      oldText: '"version": "1.0.0"',
      newText: '"version": "1.0.1"'
    }
  ],
  dryRun: false
});

目錄操作

// 創建新目錄
await manageFolder({
  action: "create",
  folderPath: "projects/new-feature"
});

// 列出目錄內容
const 文件 = await searchFilesAndFolders({
  pattern: "projects/src/*"
});

📚 詳細文檔

錯誤排除

• 錯誤：無效別名:路徑格式：確保每個參數使用別名:目錄格式。
• 錯誤：目錄不存在：指定的目錄必須存在。
• 訪問被拒絕錯誤：嘗試訪問未允許的目錄。
• 未知別名：引用的別名在服務器啟動時未定義。

項目貢獻

該項目由Martin Schlott（概念和設計）與AI助手合作完成：

• Claude 3.7 Sonnet（API設計諮詢和文檔）
• Cursor AI（實現）

README文件由Claude生成

BetterMCPFileServer 提供了一個強大而簡潔的接口，幫助您更高效地管理文件和目錄。通過定義別名:路徑對，您可以將物理路徑映射到虛擬路徑，並嚴格限制訪問權限，確保操作僅限於指定的目錄。支持寫入、讀取、編輯、移動、複製、刪除文件以及搜索文件和目錄，是開發者的理想選擇。

更多詳細信息請參閱項目文檔。