ilha MCP Server

What it does

Connects AI assistants to the ilha CLI, enabling them to create, start, and manage isolated development environments. It automates the setup of Git worktrees, Docker Compose containers, and Caddy reverse proxies to provide each feature branch with its own isolated database and service stack.

Tools

• create_worktree: Creates a new isolated working directory for a specific git branch.
• start_worktree: Launches the Docker containers associated with a worktree.
• stop_worktree: Stops the running containers for a specific worktree.
• backup_volumes: Backs up the data volumes associated with a worktree.
• restore_volumes: Restores data volumes from a backup.
• clean_volumes: Removes unused or stale data volumes.
• start_proxy: Starts the global Caddy reverse proxy for routing.
• stop_proxy: Stops the global Caddy reverse proxy.
• get_proxy_status: Checks the health and status of the routing proxy.
• list_worktrees: Returns a list of all managed worktrees and their status.
• get_worktree_info: Provides detailed configuration and status for a specific worktree.
• list_volumes: Lists all isolated data volumes across the project.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ilha": {
      "command": "ilha-mcp",
      "args": [],
      "env": {
        "ilha_WORKING_DIR": "/path/to/your/project"
      }
    }
  }
}

Supported hosts

• claude
• cursor