Tafa MCP

🚀 Tafa MCP 服務器

Tafa（在幾種非洲語言中意為“快速”）是一個可用於生產環境的模型上下文協議（MCP）服務器，它具備全面的文件系統管理能力，可與 Claude Desktop 無縫集成。

🚀 快速開始

你可以通過以下步驟快速安裝並配置 Tafa MCP 服務器，以實現與 Claude Desktop 的無縫集成。

安裝

快速安裝（NPM）

npm install -g tafa-mcp

手動安裝

git clone https://github.com/your-org/tafa-mcp.git
cd tafa-mcp
npm install
npm run install-global

配置

Claude Desktop 配置

將以下內容添加到你的 Claude Desktop 配置文件中：

• macOS/Linux：~/.config/claude/claude_desktop_config.json
• Windows：%APPDATA%\claude\claude_desktop_config.json

{
  "mcpServers": {
    "tafa-mcp": {
      "command": "tafa-mcp",
      "args": [
        "/Users/username/Documents",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Docker 配置

{
  "mcpServers": {
    "tafa-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--mount", "type=bind,src=/Users/username/Documents,dst=/workspace/Documents",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/workspace/Desktop",
        "tafa-mcp",
        "/workspace"
      ]
    }
  }
}

啟動服務器

tafa-mcp /path/to/directory1 /path/to/directory2

✨ 主要特性

🗂️ 文件操作

• read_file - 以 UTF-8 編碼讀取完整的文件內容
• write_file - 創建新文件或覆蓋現有文件（帶備份）
• append_file - 向現有文件追加內容
• copy_file - 將文件複製到新位置
• move_file - 移動/重命名文件
• delete_file - 確認並備份後刪除文件
• get_file_info - 獲取詳細的文件元數據（大小、日期、權限、哈希值）

📁 目錄操作

• create_directory - 創建目錄，可自動創建父目錄
• list_directory - 列出目錄內容，帶有文件/目錄標識（支持遞歸選項）
• delete_directory - 確認並備份後刪除目錄
• get_directory_info - 獲取目錄元數據和統計信息

🔍 搜索操作

• search_files - 遞歸搜索文件，支持模式匹配
• search_content - 在文件內容中搜索（類似 grep 的功能）
• find_duplicates - 通過內容哈希查找重複文件

🔒 安全特性

• 沙盒操作 - 僅允許在指定目錄內進行操作
• 自動備份 - 在進行破壞性操作前創建備份
• 路徑驗證 - 防止目錄遍歷攻擊
• 文件大小限制 - 防止對超大文件進行操作
• 權限檢查 - 在操作前驗證讀寫權限

📦 安裝指南

快速安裝（NPM）

npm install -g tafa-mcp

手動安裝

git clone https://github.com/your-org/tafa-mcp.git
cd tafa-mcp
npm install
npm run install-global

💻 使用示例

與 Claude 配合使用示例

配置完成後，你可以使用 Claude 執行文件操作：

"Can you read the contents of my README.md file?"
"Please create a new file called notes.txt with some sample content"
"Search for all JavaScript files in my project directory"
"Find duplicate files in my Downloads folder"

📚 詳細文檔

可用工具

文件操作

• read_file(path) - 讀取文件內容
• write_file(path, content, backup=true) - 寫入文件，可選備份
• append_file(path, content) - 向文件追加內容
• copy_file(source, destination) - 複製文件
• move_file(source, destination) - 移動/重命名文件
• delete_file(path, backup=true) - 刪除文件，可選備份
• get_file_info(path) - 獲取文件元數據

目錄操作

• create_directory(path) - 創建目錄
• list_directory(path, recursive=false, showHidden=false) - 列出目錄內容
• delete_directory(path, backup=true) - 備份後刪除目錄

搜索操作

• search_files(directory, pattern, recursive=true) - 按文件名模式搜索文件
• search_content(directory, searchTerm, filePattern="*", recursive=true) - 搜索文件內容

實用工具

• get_server_info() - 獲取服務器信息和可用工具

安全措施

Tafa MCP 實施了多項安全措施：

1. 目錄沙盒：操作限制在指定目錄內
2. 路徑驗證：防止目錄遍歷攻擊
3. 權限檢查：驗證文件系統權限
4. 文件大小限制：防止對超大文件進行操作（默認 100MB）
5. 自動備份：在進行破壞性操作前創建備份

項目結構

tafa-mcp/
├── package.json
├── README.md
├── src/
│   ├── index.js              # 主服務器入口點
│   └── tools/
│       ├── fileOperations.js     # 文件操作處理程序
│       ├── directoryOperations.js # 目錄操作處理程序
│       ├── searchOperations.js   # 搜索操作處理程序
│       └── securityManager.js    # 安全和驗證
├── config/
│   └── claude_desktop_config.example.json
└── tests/
    └── basic-tests.js

測試

運行基本測試：

npm test

貢獻代碼

1. 分叉倉庫
2. 創建功能分支
3. 進行更改
4. 為新功能添加測試
5. 提交拉取請求

許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

支持

如有問題或需要支持：

• GitHub 問題：報告錯誤
• 文檔：完整文檔

路線圖

• [ ] 歸檔操作（ZIP/TAR）
• [ ] 文件同步
• [ ] 批量操作
• [ ] 文件組織工具
• [ ] Git 集成
• [ ] 擴展搜索功能

Tafa MCP - 為 Claude Desktop 提供快速高效的文件系統操作！ 🚀