@lightninglabs/lightning-mcp-server 0.2.0

package/skills/mcp-lnc/scripts/configure.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# Configure the MCP LNC server environment.
+#
+# Usage:
+#   configure.sh                        # Interactive defaults (production mailbox)
+#   configure.sh --production           # Production settings
+#   configure.sh --dev                  # Development/regtest settings
+#   configure.sh --dev --mailbox host   # Custom mailbox server
+#   configure.sh --dev --insecure       # Dev mode with TLS verification disabled
+#
+# Writes to mcp-server/.env in the lightning-agent-kit repo.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MCP_SERVER_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)/mcp-server"
+
+MAILBOX=""
+DEV_MODE=""
+INSECURE=""
+TIMEOUT=""
+MODE=""
+
+# Parse arguments.
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --production)
+            MODE="production"
+            shift
+            ;;
+        --dev)
+            MODE="dev"
+            shift
+            ;;
+        --mailbox)
+            MAILBOX="$2"
+            shift 2
+            ;;
+        --insecure)
+            INSECURE="true"
+            shift
+            ;;
+        --timeout)
+            TIMEOUT="$2"
+            shift 2
+            ;;
+        -h|--help)
+            echo "Usage: configure.sh [options]"
+            echo ""
+            echo "Configure the MCP LNC server environment."
+            echo ""
+            echo "Modes:"
+            echo "  --production      Production settings (default mailbox, TLS enabled)"
+            echo "  --dev             Development settings (dev mode, insecure TLS)"
+            echo ""
+            echo "Options:"
+            echo "  --mailbox SERVER  Mailbox server address (host:port)"
+            echo "  --insecure        Skip TLS verification (dev only)"
+            echo "  --timeout SECS    Connection timeout (default: 30)"
+            exit 0
+            ;;
+        *)
+            echo "Unknown option: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# Verify mcp-server directory exists.
+if [ ! -d "$MCP_SERVER_DIR" ]; then
+    echo "Error: mcp-server/ directory not found at $MCP_SERVER_DIR" >&2
+    exit 1
+fi
+
+# Apply mode defaults.
+case $MODE in
+    production)
+        MAILBOX="${MAILBOX:-mailbox.terminal.lightning.today:443}"
+        DEV_MODE="${DEV_MODE:-false}"
+        INSECURE="${INSECURE:-false}"
+        ;;
+    dev)
+        MAILBOX="${MAILBOX:-mailbox.terminal.lightning.today:443}"
+        DEV_MODE="${DEV_MODE:-true}"
+        INSECURE="${INSECURE:-true}"
+        ;;
+    *)
+        MAILBOX="${MAILBOX:-mailbox.terminal.lightning.today:443}"
+        DEV_MODE="${DEV_MODE:-false}"
+        INSECURE="${INSECURE:-false}"
+        ;;
+esac
+
+TIMEOUT="${TIMEOUT:-30}"
+
+ENV_FILE="$MCP_SERVER_DIR/.env"
+
+echo "=== Configuring MCP LNC Server ==="
+echo ""
+echo "Mailbox:   $MAILBOX"
+echo "Dev mode:  $DEV_MODE"
+echo "Insecure:  $INSECURE"
+echo "Timeout:   ${TIMEOUT}s"
+echo "Output:    $ENV_FILE"
+echo ""
+
+cat > "$ENV_FILE" <<EOF
+# MCP LNC Server Configuration
+# Generated by configure.sh on $(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# Mailbox relay server
+LNC_MAILBOX_SERVER=$MAILBOX
+
+# Enable dev mode for local/regtest environments
+LNC_DEV_MODE=$DEV_MODE
+
+# Skip TLS verification (only for development!)
+LNC_INSECURE=$INSECURE
+
+# Connection timeout in seconds
+LNC_CONNECT_TIMEOUT=$TIMEOUT
+EOF
+
+chmod 600 "$ENV_FILE"
+
+echo "Configuration written to $ENV_FILE (mode 0600)"
+echo ""
+echo "Next steps:"
+echo "  1. Add to Claude Code: skills/mcp-lnc/scripts/setup-claude-config.sh"
+echo "  2. Restart Claude Code to pick up the new MCP server"

package/skills/mcp-lnc/scripts/install.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Build and install the MCP LNC server from source.
+#
+# Usage:
+#   install.sh              # Build from mcp-server/ in this repo
+#   install.sh --release    # Build optimized release binary
+#
+# Prerequisites: Go 1.24+
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MCP_SERVER_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)/mcp-server"
+RELEASE=false
+
+# Parse arguments.
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --release)
+            RELEASE=true
+            shift
+            ;;
+        -h|--help)
+            echo "Usage: install.sh [--release]"
+            echo ""
+            echo "Build and install the MCP LNC server."
+            echo ""
+            echo "Options:"
+            echo "  --release  Build optimized release binary (no dev tags)"
+            exit 0
+            ;;
+        *)
+            echo "Unknown option: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+echo "=== Installing MCP LNC Server ==="
+echo ""
+
+# Verify Go is installed.
+if ! command -v go &>/dev/null; then
+    echo "Error: Go is not installed." >&2
+    echo "Install Go from https://go.dev/dl/" >&2
+    exit 1
+fi
+
+GO_VERSION=$(go version | grep -oE 'go[0-9]+\.[0-9]+' | head -1)
+echo "Go version: $GO_VERSION"
+
+# Verify mcp-server directory exists.
+if [ ! -d "$MCP_SERVER_DIR" ]; then
+    echo "Error: mcp-server/ directory not found at $MCP_SERVER_DIR" >&2
+    echo "Are you running this from the lightning-agent-kit repo?" >&2
+    exit 1
+fi
+
+if [ ! -f "$MCP_SERVER_DIR/go.mod" ]; then
+    echo "Error: go.mod not found in $MCP_SERVER_DIR" >&2
+    exit 1
+fi
+
+echo "Source:  $MCP_SERVER_DIR"
+echo ""
+
+GOBIN=$(go env GOPATH)/bin
+
+# Build the binary.
+cd "$MCP_SERVER_DIR"
+
+if [ "$RELEASE" = true ]; then
+    echo "Building release binary..."
+    COMMIT=$(git describe --abbrev=40 --always --dirty 2>/dev/null || echo "unknown")
+    PKG="github.com/lightninglabs/lightning-agent-kit/mcp-server"
+    go build -v -ldflags "-X ${PKG}.Commit=${COMMIT}" -o "$GOBIN/mcp-lnc-server" .
+else
+    echo "Building debug binary..."
+    COMMIT=$(git describe --abbrev=40 --always --dirty 2>/dev/null || echo "unknown")
+    PKG="github.com/lightninglabs/lightning-agent-kit/mcp-server"
+    go build -v -tags "dev" -ldflags "-X ${PKG}.Commit=${COMMIT}" -o "$GOBIN/mcp-lnc-server" .
+fi
+
+echo "Done."
+echo ""
+
+# Verify installation.
+if command -v mcp-lnc-server &>/dev/null; then
+    echo "mcp-lnc-server installed: $(which mcp-lnc-server)"
+    mcp-lnc-server -version 2>/dev/null || true
+else
+    echo "Warning: mcp-lnc-server not found on PATH." >&2
+    echo "Binary built at: $GOBIN/mcp-lnc-server" >&2
+    echo "Ensure \$GOPATH/bin is in your PATH." >&2
+    echo "  export PATH=\$PATH:\$(go env GOPATH)/bin" >&2
+fi
+
+echo ""
+echo "Installation complete."
+echo ""
+echo "Next steps:"
+echo "  1. Configure: skills/mcp-lnc/scripts/configure.sh"
+echo "  2. Add to Claude Code: skills/mcp-lnc/scripts/setup-claude-config.sh"

package/skills/mcp-lnc/scripts/setup-claude-config.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+# Add the MCP LNC server to Claude Code's MCP configuration.
+#
+# Usage:
+#   setup-claude-config.sh                  # Project-level config (.mcp.json)
+#   setup-claude-config.sh --scope global   # Global config (~/.claude.json)
+#   setup-claude-config.sh --scope project  # Project config (.mcp.json)
+#   setup-claude-config.sh --docker         # Use Docker instead of local binary
+#
+# Requires: jq
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MCP_SERVER_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)/mcp-server"
+
+SCOPE="project"
+USE_DOCKER=false
+
+# Parse arguments.
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --scope)
+            SCOPE="$2"
+            shift 2
+            ;;
+        --docker)
+            USE_DOCKER=true
+            shift
+            ;;
+        -h|--help)
+            echo "Usage: setup-claude-config.sh [options]"
+            echo ""
+            echo "Add the MCP LNC server to Claude Code's MCP configuration."
+            echo ""
+            echo "Options:"
+            echo "  --scope project    Add to .mcp.json in repo root (default)"
+            echo "  --scope global     Add to ~/.claude.json (all projects)"
+            echo "  --docker           Use Docker to run the server"
+            exit 0
+            ;;
+        *)
+            echo "Unknown option: $1" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# Verify jq is available.
+if ! command -v jq &>/dev/null; then
+    echo "Error: jq is required. Install with: brew install jq" >&2
+    exit 1
+fi
+
+# Determine config file path.
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+case $SCOPE in
+    project)
+        CONFIG_FILE="$REPO_ROOT/.mcp.json"
+        ;;
+    global)
+        CONFIG_FILE="$HOME/.claude.json"
+        ;;
+    *)
+        echo "Error: --scope must be 'project' or 'global'" >&2
+        exit 1
+        ;;
+esac
+
+echo "=== Setting Up Claude Code MCP Config ==="
+echo ""
+echo "Scope:  $SCOPE"
+echo "Config: $CONFIG_FILE"
+echo ""
+
+# Load .env to read mailbox config.
+ENV_FILE="$MCP_SERVER_DIR/.env"
+LNC_MAILBOX_SERVER="mailbox.terminal.lightning.today:443"
+LNC_DEV_MODE="false"
+LNC_INSECURE="false"
+
+if [ -f "$ENV_FILE" ]; then
+    # Source only known variables.
+    while IFS='=' read -r key value; do
+        # Skip comments and empty lines.
+        [[ "$key" =~ ^#.*$ ]] && continue
+        [[ -z "$key" ]] && continue
+        # Trim whitespace.
+        key=$(echo "$key" | xargs)
+        value=$(echo "$value" | xargs)
+        case "$key" in
+            LNC_MAILBOX_SERVER) LNC_MAILBOX_SERVER="$value" ;;
+            LNC_DEV_MODE) LNC_DEV_MODE="$value" ;;
+            LNC_INSECURE) LNC_INSECURE="$value" ;;
+        esac
+    done < "$ENV_FILE"
+fi
+
+# Build the MCP server config JSON.
+if [ "$USE_DOCKER" = true ]; then
+    MCP_ENTRY=$(jq -n \
+        --arg mailbox "$LNC_MAILBOX_SERVER" \
+        --arg devmode "$LNC_DEV_MODE" \
+        --arg insecure "$LNC_INSECURE" \
+        '{
+            command: "docker",
+            args: ["run", "--rm", "-i", "--network", "host",
+                   "--env", "LNC_MAILBOX_SERVER",
+                   "--env", "LNC_DEV_MODE",
+                   "--env", "LNC_INSECURE",
+                   "mcp-lnc-server"],
+            env: {
+                LNC_MAILBOX_SERVER: $mailbox,
+                LNC_DEV_MODE: $devmode,
+                LNC_INSECURE: $insecure
+            }
+        }')
+else
+    # Check that binary exists.
+    BINARY_PATH=$(command -v mcp-lnc-server 2>/dev/null || echo "")
+    if [ -z "$BINARY_PATH" ]; then
+        echo "Warning: mcp-lnc-server not found on PATH." >&2
+        echo "Run install.sh first, or use --docker." >&2
+        echo ""
+        BINARY_PATH="mcp-lnc-server"
+    fi
+
+    MCP_ENTRY=$(jq -n \
+        --arg cmd "$BINARY_PATH" \
+        --arg mailbox "$LNC_MAILBOX_SERVER" \
+        --arg devmode "$LNC_DEV_MODE" \
+        --arg insecure "$LNC_INSECURE" \
+        '{
+            command: $cmd,
+            env: {
+                LNC_MAILBOX_SERVER: $mailbox,
+                LNC_DEV_MODE: $devmode,
+                LNC_INSECURE: $insecure
+            }
+        }')
+fi
+
+# Read or create config file.
+if [ -f "$CONFIG_FILE" ]; then
+    CONFIG=$(cat "$CONFIG_FILE")
+else
+    CONFIG='{}'
+fi
+
+# Add or update the lnc server entry.
+UPDATED=$(echo "$CONFIG" | jq --argjson entry "$MCP_ENTRY" '.mcpServers.lnc = $entry')
+
+echo "$UPDATED" | jq . > "$CONFIG_FILE"
+
+echo "MCP server config written to $CONFIG_FILE"
+echo ""
+echo "Entry added:"
+echo "$MCP_ENTRY" | jq .
+echo ""
+echo "Next steps:"
+echo "  1. Restart Claude Code to pick up the new MCP server"
+echo "  2. Use lnc_connect with a pairing phrase to connect to your node"

package/skills/mcp-lnc/templates/env.template

@@ -0,0 +1,16 @@
+# MCP LNC Server Configuration
+# Copy this file to mcp-server/.env and customize for your environment.
+
+# Default mailbox server address
+# Production: mailbox.terminal.lightning.today:443
+# Regtest:    aperture:11110
+LNC_MAILBOX_SERVER=mailbox.terminal.lightning.today:443
+
+# Enable dev mode for local/regtest environments
+LNC_DEV_MODE=false
+
+# Skip TLS verification (only for development!)
+LNC_INSECURE=false
+
+# Connection timeout in seconds
+LNC_CONNECT_TIMEOUT=30

package/versions.env

@@ -0,0 +1,23 @@
+# Container image version pins for lightning-agent-kit.
+#
+# These versions are sourced by install scripts and docker-compose templates.
+# The kit version is tracked separately in .claude-plugin/plugin.json.
+#
+# To override a version at runtime:
+#   LITD_VERSION=v0.17.0-alpha docker-start.sh
+
+# Lightning Terminal (litd) — bundles lnd, loop, pool, tapd, faraday.
+LITD_VERSION=v0.16.0-alpha
+LITD_IMAGE=lightninglabs/lightning-terminal
+
+# LND — used for the remote signer container (signing-only, no litd needed).
+LND_VERSION=v0.20.0-beta
+LND_IMAGE=lightninglabs/lnd
+
+# Aperture — L402 reverse proxy for paid API endpoints.
+APERTURE_VERSION=v0.4.2
+APERTURE_IMAGE=lightninglabs/aperture
+
+# Bitcoin Core — only used in regtest development mode.
+BITCOIN_CORE_VERSION=30
+BITCOIN_CORE_IMAGE=lightninglabs/bitcoin-core