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
• Hexagonal Architecture: Clean, maintainable, and testable codebase
• 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

Installation

NPM (Recommended)

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

Go Run (Quick Start)

You can run the installer directly without downloading or installing:

go run go.kirha.ai/mcp-installer/cmd@latest install --client <client> --key <api-key>

Direct Download

Download the latest binary from the releases page.

Docker

You can also use the installer via Docker:

# Pull the latest image
docker pull ghcr.io/kirha-ai/kirha-mcp-installer:latest

# Or pull a specific version
docker pull ghcr.io/kirha-ai/kirha-mcp-installer:v1.0.0

Available tags:

• latest - The most recent stable release
• Version tags (e.g., v1.0.0, v1.1.0) - Specific release versions

Supported platforms:

• linux/amd64
• linux/arm64

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

# Using go run directly (without npm)
go run go.kirha.ai/mcp-installer/cmd@latest install --client claude --vertical crypto --key your-api-key-here

Docker Usage

You can run the MCP installer using Docker without installing it locally:

# Basic docker run command with volume mounts for config files
docker run --rm -v ~/.config:/home/nonroot/.config \
  -v ~/Library/Application\ Support:/home/nonroot/Library/Application\ Support \
  ghcr.io/kirha-ai/kirha-mcp-installer:latest install --client claude --vertical crypto --key your-api-key-here

# Install MCP Gateway
docker run --rm -v ~/.config:/home/nonroot/.config ghcr.io/kirha-ai/kirha-mcp-installer:latest install

# Check version
docker run --rm ghcr.io/kirha-ai/kirha-mcp-installer:latest version

Note about file permissions: When using Docker with volume mounts, ensure that the mounted directories have appropriate permissions. The container runs as a non-root user (nonroot), so the mounted directories must be readable and writable by the container user. You may need to adjust permissions or use user mapping if you encounter permission issues.

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

| Client | Platform Support | Configuration Location | |--------|------------------|------------------------| | Claude Desktop | macOS, Windows, Linux | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) | | Cursor | macOS, Windows, Linux | ~/Library/Application Support/Cursor/User/settings.json (macOS) | | VS Code | macOS, Windows, Linux | ~/Library/Application Support/Code/User/settings.json (macOS) | | Claude Code | macOS, Windows, Linux | ~/.claude-code/config.json | | Docker | macOS, Windows, Linux | ./docker-compose.yml (or ./docker-compose.mcp.yml) |

Development

Prerequisites

• Go 1.22+
• Node.js 14+ (for NPM package)
• Wire (for dependency injection)

Building from Source

# Clone the repository
git clone https://go.kirha.ai/mcp-installer.git
cd mcp-installer

# Install dependencies
go mod download

# Generate Wire code
go generate ./...

# Build for current platform
go build -o mcp-installer ./cmd

# Build for all platforms
make build-all

Running Tests

# Run all tests
go test ./...

# Run tests with coverage
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out