@insforge/install/README.md

CLI tool for installing Insforge MCP servers across different AI clients

# @insforge/install

CLI tool for installing Insforge MCP servers across different AI clients.

## Installation & Usage

```bash
# Install for specific clients with required API key and base URL
npx @insforge/install --client claude-code --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client cursor --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client windsurf --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client cline --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client roocode --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client codex --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130
npx @insforge/install --client trae --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130

# Install dev version for testing (uses @insforge/mcp@dev)
npx @insforge/install --client cursor --env API_KEY=YOUR_API_KEY --env API_BASE_URL=http://localhost:7130 --dev

# With custom base URL (e.g., production server)
npx @insforge/install --client cursor --env API_KEY=YOUR_API_KEY --env API_BASE_URL=https://api.insforge.com
```

## Required Configuration

- **API_KEY** (required): Your Insforge API key for authentication
- **API_BASE_URL** (optional): Defaults to `http://localhost:7130`

## Supported Clients

- **claude-code** - Claude Desktop (uses `~/.claude/claude_mcp_config.json`)
- **cursor** - Cursor IDE (uses `~/.cursor/mcp.json`)
- **windsurf** - Windsurf IDE (uses `~/.codeium/windsurf/mcp_config.json`)
- **cline** - Cline VS Code Extension (uses `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` on macOS)
- **roocode** - Roo-Code VS Code Extension (uses `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roocline/settings/mcp_settings.json` on macOS)

## Options

```
--client <client>         Target AI client (required)
--env KEY=VALUE          Environment variables (can be used multiple times)
                         API_KEY is required
                         API_BASE_URL is optional (default: http://localhost:7130)
--dev                    Install dev version (@insforge/mcp@dev) instead of latest
```

## Examples

### Basic Installation
```bash
# Install Insforge MCP for Claude Code
npx @insforge/install --client claude-code --env API_KEY=your-api-key-here --env API_BASE_URL=http://localhost:7130

# Install for Windsurf with production server
npx @insforge/install --client windsurf --env API_KEY=your-api-key --env API_BASE_URL=https://api.insforge.com

# Install dev version for internal testing
npx @insforge/install --client cursor --env API_KEY=your-api-key --env API_BASE_URL=http://localhost:7130 --dev
```

### What This Does

The installer will:
1. Create or update the MCP configuration file for your chosen client
2. Add the Insforge MCP server with your API credentials
3. Configure it to run via `npx @insforge/mcp@latest` (or `@insforge/mcp@dev` with `--dev` flag)

After installation, restart your AI client to load the Insforge MCP server.

### Dev vs Production Versions

- **Production** (default): `npx @insforge/install --client <client> ...`
  - Installs `@insforge/mcp@latest` - stable, tested version
  - Recommended for general use

- **Development** (`--dev` flag): `npx @insforge/install --client <client> ... --dev`
  - Installs `@insforge/mcp@dev` - latest features, may be unstable
  - For team testing and early access to new features

## License

MIT