Tafa MCP

🚀 Tafa MCP Server

Tafa（いくつかのアフリカ諸語で「速い」を意味します）は、Claude Desktopとのシームレスな統合のために包括的なファイルシステム管理機能を提供する、本番環境で使用可能なモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

🗂️ ファイル操作

• 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 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

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 Issues: Report a bug
• ドキュメント: Full documentation

🚀 ロードマップ

• [ ] アーカイブ操作 (ZIP/TAR)
• [ ] ファイル同期
• [ ] バッチ操作
• [ ] ファイル整理ツール
• [ ] Git統合
• [ ] 拡張検索機能

Tafa MCP - Claude Desktopのための高速で効率的なファイルシステム操作を実現！ 🚀