Tafa MCP

🚀 Tafa MCP Server

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

🚀 Quick Start

First, install the Tafa MCP server. Then, configure it in Claude Desktop. After that, you can start the server and use Claude to perform various file system operations.

✨ Features

🗂️ File Operations

• read_file - Read the complete contents of a file 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, creating parent directories if necessary.
• list_directory - List contents with file/directory indicators (recursive option available).
• delete_directory - Remove directories with confirmation and backup.
• get_directory_info - Get directory metadata and statistics.

🔍 Search Operations

• search_files - Perform a recursive file search with pattern matching.
• search_content - Search within file contents (similar to grep functionality).
• find_duplicates - Find duplicate files by content hash.

🔒 Security Features

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

📦 Installation

Quick Install (NPM)

npm install -g tafa-mcp

Manual Installation

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

📚 Documentation

Claude Desktop Configuration

Add the following configuration to your Claude Desktop configuration file:

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

{
  "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"
      ]
    }
  }
}

💻 Usage Examples

Starting the Server

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

Example Usage with Claude

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

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

🔧 Technical Details

Available Tools

File Operations

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

Directory Operations

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

Search Operations

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

Utility

• get_server_info() - Get server information and available tools.

Security

Tafa MCP implements several security measures:

1. Directory Sandboxing: Restrict operations to specified directories.
2. Path Validation: Prevent directory traversal attacks.
3. Permission Checks: Validate file system permissions.
4. File Size Limits: Prevent operations on extremely large files (default is 100MB).
5. Automatic Backups: Create backups before destructive operations.

Project Structure

tafa-mcp/
├── package.json
├── README.md
├── src/
│   ├── index.js              # Main server entry point
│   └── tools/
│       ├── fileOperations.js     # File operation handlers
│       ├── directoryOperations.js # Directory operation handlers
│       ├── searchOperations.js   # Search operation handlers
│       └── securityManager.js    # Security and validation
├── config/
│   └── claude_desktop_config.example.json
└── tests/
    └── basic-tests.js

🧪 Testing

Run basic tests:

npm test

🤝 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 the 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! 🚀