MCP Installer

MCP Installer is a CLI tool that simplifies the installation of Kirha MCP (Model Context Protocol) server across multiple development environments.

Features

• Multi-platform support: Works on macOS, Linux, and Windows
• Multiple client support: Claude Desktop, Cursor, VS Code, Claude Code CLI, and Docker
• Automatic backup: Creates backups before modifying configurations
• Dry-run mode: Preview changes before applying them
• Cross-platform builds: Automated builds for multiple architectures
• Plan mode support: Enable/disable tool plan mode for enhanced AI assistance
• Flexible updates: Update configurations without requiring API key changes

Operating Modes

By default, the gateway operates in auto mode, where both planning and execution are performed automatically in a single request. Planning is deterministic: semantically identical prompts yield the same composition of tool(s).

If the environment variable TOOL_PLAN_MODE_ENABLED is set to true, the gateway switches to planning mode, which separates the planning and execution steps. When we ship Kirha’s payment, you will be able to accept or reject the plan before it is executed.

Auto mode:

• execute-tool-planning: Automatically performs both planning and execution in a single request. This tool internally creates the plan and immediately executes it, returning the final result in one step.

Plan mode:

• create-tool-planning: Prepares a query and generates a plan_id for later execution. This tool allows creating a plan in advance, which can then be reviewed before being executed.
• execute-tool-planning: Executes a previously created plan by providing its plan_id. This step runs the predefined plan and returns the result.

Installation

npx @kirha/mcp-installer install --client <client> --key <api-key>

Direct Download

Download the latest binary from the releases page.

Usage

Install

# Install for Claude Desktop
npx @kirha/mcp-installer install --client claude --vertical crypto --key your-api-key-here

# Install for Docker
npx @kirha/mcp-installer install --client docker --vertical crypto --key your-api-key-here

# Install for Cursor IDE with plan mode enabled
npx @kirha/mcp-installer install --client cursor --vertical crypto --key your-api-key-here --enable-plan-mode

Update

# Update API key for Claude Desktop
npx @kirha/mcp-installer update --client claude --vertical crypto --key your-new-api-key

# Enable plan mode without changing API key
npx @kirha/mcp-installer update --client claude --vertical crypto --enable-plan-mode

# Disable plan mode without changing API key
npx @kirha/mcp-installer update --client claude --vertical crypto --disable-plan-mode

# Update API key and enable plan mode
npx @kirha/mcp-installer update --client docker --vertical crypto --key your-new-api-key --enable-plan-mode

# Update configuration preserving existing settings
npx @kirha/mcp-installer update --client cursor --vertical crypto

Remove

# Remove from VS Code
npx @kirha/mcp-installer remove --client vscode --vertical crypto

# Remove from Cursor
npx @kirha/mcp-installer remove --client cursor --vertical crypto

Show Configuration

# Show current configuration for Claude Desktop
npx @kirha/mcp-installer show --client claude --vertical crypto

# Show configuration for Docker
npx @kirha/mcp-installer show --client docker --vertical crypto

# Show configuration for VS Code with verbose output
npx @kirha/mcp-installer show --client vscode --vertical crypto --verbose

Commands

• install - Install MCP server (fails if already exists)
• update - Update existing MCP server configuration (preserves existing settings when not specified)
• remove - Remove MCP server from configuration
• show - Display current MCP server configuration

Options

Common Options

• --client, -c - Client to operate on (required)
• --vertical - Vertical to operate on (crypto, utils) (required)
• --config-path - Custom configuration file path (optional)
• --dry-run - Show what would be changed without making changes (install/update/remove only)
• --verbose, -v - Enable verbose logging

Supported Clients