Butler 🛎️

Butler is a lightweight MCP desktop client built in Rust using the Tauri framework. It’s similar to Cursor.ai but designed specifically for Web3 development by cutting unnecessary background tasks and extensions to achieve a minimal memory footprint. This allows MCP tools to fully support smart contract workflows and multi-chain data interactions.

Features

• Claude AI Integration - Real-time AI code assistance with streaming responses, leveraging available MCP tools for various use cases.

• Blockchain Support - Natural language access to multi-chain data (Ethereum, Polygon, Arbitrum, Base) via Nodit APIs via MCPs.

• MCP Protocol Integration - Extensible ecosystem for AI tools that support many use cases from smart contract development, testing, and auditing to DeFi portfolio management and protocol governance.

• File Management - Full project workspace with syntax highlighting, file navigation, and editing capabilities.

• Lightweight & Fast - Rust-based desktop application built with Tauri optimized for low memory usage and fast performance.

Quick Start

Prerequisites

• Node.js 18+
• Rust (for Tauri)

Installation

# Clone repository
git clone https://github.com/tamago-labs/butler.git
cd butler

# Install dependencies
npm install

# Run development server
npm run tauri dev

Authentication

Sign in with demo access key: butler-demo

Usage

Basic Workflow

1. Open Project: Ctrl+Shift+O to open folder
2. AI Chat: Ctrl+J to toggle AI panel
3. Quick Actions: Use AI buttons (Analyze, Debug, Explain, Optimize)
4. MCP Tools: Access blockchain data and file operations

Keyboard Shortcuts

• Ctrl+N - New file
• Ctrl+O - Open file
• Ctrl+S - Save file
• Ctrl+J - Toggle AI panel
• Ctrl+Shift+P - Command palette

AI Features

• Code analysis and suggestions
• Bug detection and fixes
• Code explanation
• Performance optimization
• Blockchain smart contract analysis

Blockchain Integration

• Multi-chain wallet analysis
• Smart contract inspection
• Token balance queries
• Transaction history
• DeFi protocol integration

MCP Tools

Butler supports Model Context Protocol for extensible AI capabilities:

• Nodit - Blockchain data across multiple networks
• Filesystem - File operations and project management
• Git - Repository status and history
• Database - SQLite query capabilities

Architecture

┌─────────────────┐    ┌──────────────┐    ┌─────────────┐
│   React UI      │────│  Claude AI   │────│ MCP Servers │
│   (Frontend)    │    │  (Assistant) │    │   (Tools)   │
└─────────────────┘    └──────────────┘    └─────────────┘
         │                       │                  │
┌─────────────────┐    ┌──────────────┐    ┌─────────────┐
│   Tauri Core    │    │ File Manager │    │ Nodit APIs  │
│   (Backend)     │    │   (Hooks)    │    │ (Blockchain)│
└─────────────────┘    └──────────────┘    └─────────────┘

Development

Project Structure

src/
├── components/          # React components
├── hooks/              # Custom React hooks
├── services/           # AI and MCP services
├── utils/              # Utility functions
└── test/               # Test files

src-tauri/              # Rust backend
├── src/                # Tauri application code
└── Cargo.toml          # Rust dependencies

License

MIT License