Iru MCP

#!/usr/bin/env bash

################################################################################################
# Version
################################################################################################
# 1.0.0
################################################################################################
# Copyright (c) 2026 Iru, Inc. — MIT License (see License Information below).
################################################################################################
# Documentation
################################################################################################
# Claude Desktop — add Iru MCP via mcp-remote (macOS).
# Public Iru docs (prerequisites, env vars, and setup context):
# https://docs.iru.com/en/endpoint/api/model-context-protocol/iru-mcp
################################################################################################
# License Information
################################################################################################
#
# Copyright 2026 Iru, Inc.
#
# Permission is hereby granted, free of charge, to any person obtaining a copy of this
# software and associated documentation files (the "Software"), to deal in the Software
# without restriction, including without limitation the rights to use, copy, modify, merge,
# publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
# to whom the Software is furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all copies or
# substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
# FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
# OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
# DEALINGS IN THE SOFTWARE.
#
################################################################################################

set -euo pipefail

# ── Configuration ────────────────────────────────────────────────────
# Export these BEFORE running; do not put secrets directly in this file.
#
# Match the MCP URL and secrets from Iru’s copied snippet (same URL as in Cursor ~/.cursor/mcp.json → mcpServers.iru).
#
# Example exports (tenant hostname and connector slug come from your tenant; copy from **Copy MCP configuration**):
#   export IRU_MCP_SERVER="https://YOUR_TENANT.connect.iru.dev/mcp-server/connector/YOUR_CONNECTOR_SLUG/tools"
#   export IRU_MCP_API_KEY="YOUR_API_KEY"
#   export IRU_MCP_PROFILE_ID="YOUR_PROFILE_ID"
#
# Cursor uses HTTP MCP (URL + headers). Claude Desktop uses this stdio bridge via npx + mcp-remote.
# Override the bridge package if needed:
IRU_MCP_REMOTE_PKG="${IRU_MCP_REMOTE_PKG:-mcp-remote@0.1.13}"

IRU_MCP_API_KEY="${IRU_MCP_API_KEY:?Set IRU_MCP_API_KEY before running this script}"
IRU_MCP_PROFILE_ID="${IRU_MCP_PROFILE_ID:?Set IRU_MCP_PROFILE_ID before running this script}"
IRU_MCP_SERVER="${IRU_MCP_SERVER:?Set IRU_MCP_SERVER before running this script}"

# ── Detect config path by OS ────────────────────────────────────────
case "$(uname -s)" in
  Darwin)  CONFIG_DIR="$HOME/Library/Application Support/Claude" ;;
  Linux)   CONFIG_DIR="$HOME/.config/Claude" ;;
  MINGW*|MSYS*|CYGWIN*)
           CONFIG_DIR="$APPDATA/Claude" ;;
  *)       echo "Unsupported OS: $(uname -s)" >&2; exit 1 ;;
esac

CONFIG_FILE="$CONFIG_DIR/claude_desktop_config.json"

# ── Ensure dependencies ─────────────────────────────────────────────
if ! command -v npx &>/dev/null; then
  echo "Error: npx not found. Install Node.js (v20+) first." >&2
  exit 1
fi

if ! command -v jq &>/dev/null; then
  echo "Error: jq not found. Install it (brew install jq / apt install jq)." >&2
  exit 1
fi

# ── Build the server entry (stdio → mcp-remote → same URL/headers as Cursor) ───
SERVER_ENTRY=$(jq -n \
  --arg pkg "$IRU_MCP_REMOTE_PKG" \
  --arg url "$IRU_MCP_SERVER" \
  --arg key "$IRU_MCP_API_KEY" \
  --arg profile "$IRU_MCP_PROFILE_ID" \
  '{
    command: "npx",
    args: [
      "-y",
      $pkg,
      $url,
      "--header",
      ("X-API-Key: " + $key),
      "--header",
      ("X-MCP-Profile: " + $profile)
    ]
  }')

# ── Merge into existing config (or create new) ─────────────────────
mkdir -p "$CONFIG_DIR"

if [[ -f "$CONFIG_FILE" ]]; then
  cp "$CONFIG_FILE" "$CONFIG_FILE.bak"
  echo "Backed up existing config to $(basename "$CONFIG_FILE").bak"

  UPDATED=$(jq --argjson entry "$SERVER_ENTRY" \
    '.mcpServers.iru = $entry' "$CONFIG_FILE")
else
  UPDATED=$(jq -n --argjson entry "$SERVER_ENTRY" \
    '{ mcpServers: { iru: $entry } }')
fi

echo "$UPDATED" > "$CONFIG_FILE"

# ── Done ────────────────────────────────────────────────────────────
echo ""
echo "✓ IRU MCP server added to Claude Desktop config."
echo "  Config: $CONFIG_FILE"
echo "  Bridge package: ${IRU_MCP_REMOTE_PKG}"
echo ""
echo "Next steps:"
echo "  1. Fully quit Claude Desktop (Cmd+Q / right-click tray → Quit)"
echo "  2. Reopen it"
echo "  3. Look for the hammer/tools icon at the bottom of a new chat"
echo ""
echo "Sanity check:"
echo "  IRU MCP URL matches your working Cursor ~/.cursor/mcp.json (mcpServers.iru URL; host .iru.dev,"
echo "  connector path must match your tenant’s snippet. Avoid typos such as wrong subdomain or connector slug)."
echo ""
echo "(Credentials not echoed; verify in $CONFIG_FILE if needed)"

#Requires -Version 5.1

<#
.SYNOPSIS
    Add Iru’s hosted MCP URL to Claude Desktop on Windows via mcp-remote (stdio bridge).

.DESCRIPTION
    Merges an iru MCP server entry into Claude Desktop's claude_desktop_config.json using npx
    and mcp-remote as a stdio-to-HTTP bridge (same MCP URL and headers as Iru's MCP snippet for
    Cursor-style HTTP MCP).

.NOTES
    Version            : 1.0.0
    Copyright          : (c) 2026 Iru, Inc.
    License            : MIT License — full text in the License Information block in this script file.

    Compatible with    : Windows PowerShell 5.1 and PowerShell 7+
    Prerequisites      : Node.js 20+ (npx on PATH); Claude Desktop for Windows

    Config path        : %APPDATA%\Claude\claude_desktop_config.json

    For prerequisites, env vars, and full setup context, see Related Links (Get-Help -Full).

.PARAMETER Interactive
    Prompts for MCP URL, X-API-Key value, and X-MCP-Profile ID instead of using process env vars only.

.EXAMPLE
    $env:IRU_MCP_SERVER='https://YOUR_TENANT.connect.iru.dev/mcp-server/connector/YOUR_CONNECTOR_SLUG/tools'
    $env:IRU_MCP_API_KEY='YOUR_API_KEY'
    $env:IRU_MCP_PROFILE_ID='YOUR_PROFILE_ID'
    .\iru-mcp-claude-desktop-windows.ps1

.LINK
    https://docs.iru.com/en/endpoint/api/model-context-protocol/iru-mcp
#>

################################################################################################
# License Information
################################################################################################
#
# Copyright 2026 Iru, Inc.
#
# Permission is hereby granted, free of charge, to any person obtaining a copy of this
# software and associated documentation files (the "Software"), to deal in the Software
# without restriction, including without limitation the rights to use, copy, modify, merge,
# publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
# to whom the Software is furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all copies or
# substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
# PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
# FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
# OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
# DEALINGS IN THE SOFTWARE.
#
################################################################################################

[CmdletBinding()]
param (
    [switch] $Interactive
)

Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'

function Resolve-IruSecrets {
    if ($Interactive) {
        [string]$s = Read-Host 'IRU MCP server URL (HTTPS, from Iru MCP snippet)'
        if ([string]::IsNullOrWhiteSpace($s)) { throw 'IRU_MCP_SERVER URL is required.' }
        $env:IRU_MCP_SERVER = $s.Trim()

        [string]$k = Read-Host 'X-API-Key value (paste the exact value from your Iru MCP configuration snippet)'
        if ([string]::IsNullOrWhiteSpace($k)) { throw 'IRU_MCP_API_KEY is required.' }
        $env:IRU_MCP_API_KEY = $k.Trim()

        [string]$p = Read-Host 'X-MCP-Profile ID'
        if ([string]::IsNullOrWhiteSpace($p)) { throw 'IRU_MCP_PROFILE_ID is required.' }
        $env:IRU_MCP_PROFILE_ID = $p.Trim()
    }

    foreach ($pair in @(
            @{ Var = 'IRU_MCP_API_KEY';     Msg = 'Set IRU_MCP_API_KEY (or pass -Interactive)' },
            @{ Var = 'IRU_MCP_PROFILE_ID'; Msg = 'Set IRU_MCP_PROFILE_ID (or pass -Interactive)' },
            @{ Var = 'IRU_MCP_SERVER';     Msg = 'Set IRU_MCP_SERVER (or pass -Interactive)' }
        )) {
        $v = [Environment]::GetEnvironmentVariable($pair.Var, 'Process')
        if (-not [string]::IsNullOrWhiteSpace($v)) { continue }

        throw $pair.Msg
    }
}

Resolve-IruSecrets

$iruServer = ($env:IRU_MCP_SERVER).Trim().TrimEnd('/')
$iruKey = $env:IRU_MCP_API_KEY
$iruProfile = $env:IRU_MCP_PROFILE_ID

$remotePkg = if (-not [string]::IsNullOrWhiteSpace($env:IRU_MCP_REMOTE_PKG)) {
    $env:IRU_MCP_REMOTE_PKG.Trim()
} else {
    'mcp-remote@0.1.13'
}

if (-not (Get-Command npx -ErrorAction SilentlyContinue)) {
    throw 'npx not found. Install Node.js 20+ and ensure npm is on PATH, then rerun.'
}

$configDir = Join-Path $env:APPDATA 'Claude'
$configPath = Join-Path $configDir 'claude_desktop_config.json'
$bakPath = "$configPath.bak"

$newIruArgs = New-Object System.Collections.ArrayList
[void]$newIruArgs.AddRange(@(
        '-y',
        $remotePkg,
        $iruServer,
        '--header',
        "X-API-Key: $iruKey",
        '--header',
        "X-MCP-Profile: $iruProfile"
    ))

$newIruEntry = New-Object PSCustomObject -Property @{
    command = 'npx'
    args    = $newIruArgs.ToArray()
}

[System.IO.Directory]::CreateDirectory($configDir) | Out-Null

if (Test-Path -LiteralPath $configPath) {
    Copy-Item -LiteralPath $configPath -Destination $bakPath -Force
    Write-Host "Backed up existing config to $(Split-Path $bakPath -Leaf)" -ForegroundColor DarkGray

    try {
        $raw = Get-Content -LiteralPath $configPath -Raw -Encoding UTF8
        $cfg = $raw | ConvertFrom-Json

        # Avoid $cfg.mcpServers when StrictMode hides missing-member access
        $msMember = @( $cfg.PSObject.Properties.Match('mcpServers') )

        $needNewServers = (($msMember.Count -eq 0) -or ($null -eq $msMember[0].Value))

        if ($needNewServers) {
            $mcpServersOnlyIru = New-Object PSCustomObject
            $mcpServersOnlyIru | Add-Member -MemberType NoteProperty -Name iru -Value $newIruEntry -Force
            $cfg | Add-Member -MemberType NoteProperty -Name mcpServers -Value $mcpServersOnlyIru -Force
        }
        else {
            $msMember[0].Value | Add-Member -MemberType NoteProperty -Name iru -Value $newIruEntry -Force
        }
    }
    catch {
        throw @"
Failed to read or merge $configPath :

$($_)

Repair the JSON manually, restore from $($bakPath), or rename the corrupt file aside and rerun.

"@
    }
}
else {
    $mcpServers = New-Object PSCustomObject
    $mcpServers | Add-Member -MemberType NoteProperty -Name iru -Value $newIruEntry -Force

    $cfg = New-Object PSCustomObject
    $cfg | Add-Member -MemberType NoteProperty -Name mcpServers -Value $mcpServers -Force
}

# -Depth avoids truncating nested args (ConvertTo-Json default depth is shallow on 5.x)
$payload = $cfg | ConvertTo-Json -Depth 20

$utf8 = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText($configPath, $payload, $utf8)

Write-Host ''
Write-Host 'IRU MCP (iru) merged into Claude Desktop config.' -ForegroundColor Green
Write-Host "Config: $configPath"
Write-Host "Bridge : npx $remotePkg -> $iruServer"

Write-Host @'

Next steps:
  1. Fully exit Claude Desktop (tray icon -> Quit)
  2. Reopen Claude Desktop
  3. Open a new chat and confirm tools attach

'@