#!/bin/bash
set -euo pipefail
# SAP Documentation MCP Server Setup Script
printf '🚀 Setting up SAP Documentation MCP Server...\n'
# Install dependencies
printf '📦 Installing dependencies...\n'
npm install
# Initialize and update git submodules
printf '📚 Initializing documentation submodules...\n'
# Initialize/update submodules (including new ones) to latest
printf ' → Syncing submodule configuration...\n'
git submodule sync --recursive
VARIANT_NAME="${MCP_VARIANT:-}"
if [ -z "$VARIANT_NAME" ] && [ -f .mcp-variant ]; then
VARIANT_NAME="$(tr -d '[:space:]' < .mcp-variant)"
fi
if [ -z "$VARIANT_NAME" ]; then
VARIANT_NAME="sap-docs"
fi
ALLOWED_SUBMODULE_PATHS="$({
node --input-type=module -e '
import fs from "node:fs";
import path from "node:path";
const variant = (process.env.MCP_VARIANT || "").trim() || fs.readFileSync(path.resolve(process.cwd(), ".mcp-variant"), "utf8").trim() || "sap-docs";
const configPath = path.resolve(process.cwd(), "config", "variants", `${variant}.json`);
const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
for (const item of config.submodulePaths || []) {
console.log(item);
}
';
} 2>/dev/null || true)"
if [ -z "$ALLOWED_SUBMODULE_PATHS" ]; then
printf '⚠️ Could not resolve variant submodule paths, defaulting to all .gitmodules entries.\n'
fi
printf ' → Active MCP variant: %s\n' "$VARIANT_NAME"
# Store allowed paths as newline-delimited string (bash 3.2 compatible, no associative arrays)
ALLOWED_SUBMODULES_LIST="$ALLOWED_SUBMODULE_PATHS"
# Collect submodules from .gitmodules
printf ' → Ensuring variant submodules are present (shallow, single branch)...\n'
while IFS= read -r line; do
name=$(echo "$line" | awk '{print $1}' | sed -E 's/^submodule\.([^ ]*)\.path$/\1/')
path=$(echo "$line" | awk '{print $2}')
branch=$(git config -f .gitmodules "submodule.${name}.branch" || echo main)
url=$(git config -f .gitmodules "submodule.${name}.url")
# Skip if missing required fields
[ -z "$path" ] && continue
[ -z "$url" ] && continue
if [ -n "$ALLOWED_SUBMODULES_LIST" ] && ! printf '%s\n' "$ALLOWED_SUBMODULES_LIST" | grep -qxF "$path"; then
printf ' • %s (skipped for variant %s)\n' "$path" "$VARIANT_NAME"
continue
fi
printf ' • %s (branch: %s)\n' "$path" "$branch"
if [ ! -d "$path/.git" ]; then
printf ' - cloning shallow...\n'
GIT_LFS_SKIP_SMUDGE=1 git clone --filter=blob:none --no-tags --single-branch --depth 1 --branch "$branch" "$url" "$path" || {
printf ' ! clone failed for %s, retrying with master\n' "$path"
GIT_LFS_SKIP_SMUDGE=1 git clone --filter=blob:none --no-tags --single-branch --depth 1 --branch master "$url" "$path" || true
}
else
printf ' - updating shallow to latest %s...\n' "$branch"
# Limit origin to a single branch and fetch shallow
git -C "$path" config --unset-all remote.origin.fetch >/dev/null 2>&1 || true
git -C "$path" config remote.origin.fetch "+refs/heads/${branch}:refs/remotes/origin/${branch}"
git -C "$path" remote set-branches origin "$branch" || true
# configure partial clone + no-tags for smaller fetches
git -C "$path" config remote.origin.tagOpt --no-tags || true
git -C "$path" config remote.origin.promisor true || true
git -C "$path" config remote.origin.partialclonefilter blob:none || true
if ! GIT_LFS_SKIP_SMUDGE=1 git -C "$path" fetch --filter=blob:none --no-tags --depth 1 --prune origin "$branch"; then
printf ' ! fetch failed for %s, trying master\n' "$branch"
git -C "$path" config remote.origin.fetch "+refs/heads/master:refs/remotes/origin/master"
git -C "$path" remote set-branches origin master || true
GIT_LFS_SKIP_SMUDGE=1 git -C "$path" fetch --filter=blob:none --no-tags --depth 1 --prune origin master || true
branch=master
fi
# Checkout/reset to the fetched tip
git -C "$path" checkout -B "$branch" "origin/$branch" 2>/dev/null || git -C "$path" checkout "$branch" || true
git -C "$path" reset --hard "origin/$branch" 2>/dev/null || true
# Compact local repository storage (keeps only the shallow pack)
git -C "$path" reflog expire --expire=now --all >/dev/null 2>&1 || true
git -C "$path" gc --prune=now --aggressive >/dev/null 2>&1 || true
fi
done < <(git config -f .gitmodules --get-regexp 'submodule\..*\.path')
if [ -n "${SKIP_NESTED_SUBMODULES:-}" ]; then
printf ' → Skipping nested submodule initialization (SKIP_NESTED_SUBMODULES=1)\n'
else
printf ' → Initializing nested submodules to pinned commits (shallow)...\n'
git submodule update --init --recursive --depth 1 || true
fi
printf ' → Current submodule status:\n'
git submodule status --recursive || true
# Build the search index
printf '🔍 Building search index...\n'
npm run build
printf '✅ Setup complete!\n\n'
printf 'To start the MCP server:\n'
printf ' npm start\n\n'
printf 'To use in Cursor:\n'
printf '1. Open Cursor IDE\n'
printf '2. Go to Tools → Add MCP Server\n'
printf '3. Use command: npm start\n'
printf '4. Set working directory to: %s\n' "$(pwd)"
