Tafa MCP Server

🚀 Tafa MCP Server

Tafa (meaning "quick" in several African languages) is a production-ready Model Context Protocol (MCP) server that provides comprehensive file system management capabilities for seamless integration with Claude Desktop.

✨ Features

🗂️ File Operations

• read_file - Read complete file contents with UTF-8 encoding
• write_file - Create new files or overwrite existing ones (with backup)
• append_file - Add content to existing files
• copy_file - Copy files to new locations
• move_file - Move/rename files
• delete_file - Remove files with confirmation and backup
• get_file_info - Get detailed file metadata (size, dates, permissions, hash)

📁 Directory Operations

• create_directory - Create directories with parent creation
• list_directory - List contents with file/directory indicators (recursive option)
• delete_directory - Remove directories with confirmation and backup
• get_directory_info - Get directory metadata and statistics

🔍 Search Operations

• search_files - Recursive file search with pattern matching
• search_content - Search within file contents (grep-like functionality)
• find_duplicates - Find duplicate files by content hash

🔒 Security Features

• Sandboxed Operations - Only allow operations within specified directories
• Automatic Backups - Creates backups before destructive operations
• Path Validation - Prevents directory traversal attacks
• File Size Limits - Prevents operations on extremely large files
• Permission Checks - Validates read/write permissions before operations

🛠️ Installation

Quick Install (NPM)

Manual Installation

⚙️ Configuration

Claude Desktop Configuration

Add to your Claude Desktop configuration file:

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

Docker Configuration

🚀 Usage

Starting the Server

Example Usage with Claude

Once configured, you can use Claude to perform file operations:

🔧 Available Tools

File Operations

• read_file(path) - Read file contents
• write_file(path, content, backup=true) - Write file with optional backup
• append_file(path, content) - Append content to file
• copy_file(source, destination) - Copy file
• move_file(source, destination) - Move/rename file
• delete_file(path, backup=true) - Delete file with optional backup
• get_file_info(path) - Get file metadata

Directory Operations

• create_directory(path) - Create directory
• list_directory(path, recursive=false, showHidden=false) - List directory contents
• delete_directory(path, backup=true) - Delete directory with backup

Search Operations

• search_files(directory, pattern, recursive=true) - Search files by name pattern
• search_content(directory, searchTerm, filePattern="*", recursive=true) - Search file contents

Utility

• get_server_info() - Get server information and available tools

🔐 Security

Tafa MCP implements several security measures:

1. Directory Sandboxing: Operations are restricted to specified directories
2. Path Validation: Prevents directory traversal attacks
3. Permission Checks: Validates file system permissions
4. File Size Limits: Prevents operations on extremely large files (100MB default)
5. Automatic Backups: Creates backups before destructive operations

🗂️ Project Structure

🧪 Testing

Run basic tests:

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🆘 Support

For issues and support:

• GitHub Issues: Report a bug
• Documentation: Full documentation

🚀 Roadmap

• Archive operations (ZIP/TAR)
• File synchronization
• Batch operations
• File organization tools
• Git integration
• Extended search capabilities

Tafa MCP - Making file system operations fast and efficient for Claude Desktop! 🚀