feat: add install script and rewrite README in Hebrew
One-liner install: curl | bash that builds from source, configures global MCP in ~/.claude/settings.json, handles duplicates, and supports interactive multi-server setup. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Executable
+376
@@ -0,0 +1,376 @@
|
||||
#!/bin/bash
|
||||
# install.sh - Install/upgrade gitea-mcp and configure global MCP server
|
||||
#
|
||||
# Usage:
|
||||
# curl -fsSL https://gitea.dev.marcus-law.co.il/Chaim/gitea-mcp/raw/branch/main/install.sh | bash
|
||||
# # or locally:
|
||||
# bash install.sh
|
||||
#
|
||||
# Options (via env vars):
|
||||
# GITEA_MCP_DIR=~/custom-dir # Custom install directory (default: ~/.gitea-mcp)
|
||||
# GITEA_MCP_BRANCH=dev # Custom branch (default: main)
|
||||
# GITEA_DEFAULT_HOST=https://... # Default Gitea host
|
||||
# GITEA_DEFAULT_TOKEN=xxx # Default Gitea token
|
||||
# AUTO_YES=1 # Skip all prompts
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
REPO_URL="https://gitea.dev.marcus-law.co.il/Chaim/gitea-mcp.git"
|
||||
INSTALL_DIR="${GITEA_MCP_DIR:-$HOME/.gitea-mcp}"
|
||||
BRANCH="${GITEA_MCP_BRANCH:-main}"
|
||||
AUTO_YES="${AUTO_YES:-0}"
|
||||
|
||||
MCP_NAME="gitea-dev"
|
||||
BINARY_NAME="gitea-mcp"
|
||||
GOBIN="${GOPATH:-$HOME/go}/bin"
|
||||
BINARY_PATH="$GOBIN/$BINARY_NAME"
|
||||
|
||||
CLAUDE_JSON="$HOME/.claude.json"
|
||||
CLAUDE_SETTINGS="$HOME/.claude/settings.json"
|
||||
|
||||
# ── Helpers ─────────────────────────────────────────────────────────────────
|
||||
|
||||
RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; CYAN='\033[0;36m'; NC='\033[0m'
|
||||
info() { echo -e "${CYAN}>>>${NC} $*"; }
|
||||
ok() { echo -e "${GREEN} ✓${NC} $*"; }
|
||||
warn() { echo -e "${YELLOW} !${NC} $*"; }
|
||||
error() { echo -e "${RED} ✗${NC} $*" >&2; }
|
||||
|
||||
ask_yes_no() {
|
||||
local prompt="$1"
|
||||
if [ "$AUTO_YES" = "1" ]; then return 0; fi
|
||||
if [ -e /dev/tty ]; then
|
||||
printf "%s [Y/n] " "$prompt"
|
||||
local answer=""
|
||||
read -r answer < /dev/tty 2>/dev/null || answer="y"
|
||||
case "$answer" in [nN]*) return 1 ;; *) return 0 ;; esac
|
||||
else
|
||||
return 0
|
||||
fi
|
||||
}
|
||||
|
||||
ask_input() {
|
||||
local prompt="$1" var_name="$2" default="${3:-}"
|
||||
if [ -e /dev/tty ]; then
|
||||
if [ -n "$default" ]; then
|
||||
printf "%s [%s]: " "$prompt" "$default"
|
||||
else
|
||||
printf "%s: " "$prompt"
|
||||
fi
|
||||
local answer=""
|
||||
read -r answer < /dev/tty 2>/dev/null || answer=""
|
||||
if [ -z "$answer" ]; then answer="$default"; fi
|
||||
eval "$var_name=\$answer"
|
||||
else
|
||||
eval "$var_name=\$default"
|
||||
fi
|
||||
}
|
||||
|
||||
# ── Step 0: Prerequisites ──────────────────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
echo -e "${CYAN}=== Gitea MCP Server Installer ===${NC}"
|
||||
echo ""
|
||||
|
||||
info "Checking prerequisites..."
|
||||
|
||||
if ! command -v go &>/dev/null; then
|
||||
error "Go is required but not found. Install from https://go.dev/dl/"
|
||||
exit 1
|
||||
fi
|
||||
GO_VERSION=$(go version | grep -oP 'go\d+\.\d+')
|
||||
ok "go ($GO_VERSION)"
|
||||
|
||||
if ! command -v git &>/dev/null; then
|
||||
error "git is required but not found"
|
||||
exit 1
|
||||
fi
|
||||
ok "git ($(git --version | cut -d' ' -f3))"
|
||||
|
||||
if ! command -v jq &>/dev/null; then
|
||||
error "jq is required but not found. Install: sudo apt install jq"
|
||||
exit 1
|
||||
fi
|
||||
ok "jq ($(jq --version 2>/dev/null))"
|
||||
|
||||
# ── Step 1: Clone or update ────────────────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
if [ -d "$INSTALL_DIR/.git" ]; then
|
||||
info "Updating existing installation in $INSTALL_DIR ..."
|
||||
cd "$INSTALL_DIR"
|
||||
git fetch origin 2>&1 | tail -2
|
||||
git reset --hard "origin/$BRANCH" 2>&1 | tail -1
|
||||
ok "Updated to latest $BRANCH"
|
||||
elif [ -d "$INSTALL_DIR" ]; then
|
||||
# Directory exists but is not a git repo — remove and re-clone
|
||||
warn "$INSTALL_DIR exists but is not a git repo, re-cloning..."
|
||||
rm -rf "$INSTALL_DIR"
|
||||
git clone --branch "$BRANCH" --single-branch "$REPO_URL" "$INSTALL_DIR" 2>&1 | tail -2
|
||||
cd "$INSTALL_DIR"
|
||||
ok "Cloned"
|
||||
else
|
||||
info "Cloning to $INSTALL_DIR ..."
|
||||
git clone --branch "$BRANCH" --single-branch "$REPO_URL" "$INSTALL_DIR" 2>&1 | tail -2
|
||||
cd "$INSTALL_DIR"
|
||||
ok "Cloned"
|
||||
fi
|
||||
|
||||
# ── Step 2: Build ──────────────────────────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
info "Building $BINARY_NAME ..."
|
||||
mkdir -p "$GOBIN"
|
||||
go build -o "$BINARY_PATH" . 2>&1
|
||||
VERSION=$("$BINARY_PATH" --version 2>/dev/null || echo "unknown")
|
||||
ok "Built $BINARY_PATH ($VERSION)"
|
||||
|
||||
# ── Step 3: Find existing MCP config ───────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
info "Checking existing MCP configuration..."
|
||||
|
||||
# Determine where the MCP entry currently lives
|
||||
MCP_CONFIG_FILE=""
|
||||
EXISTING_ENTRY=""
|
||||
|
||||
# Check global settings.json first (preferred location)
|
||||
if [ -f "$CLAUDE_SETTINGS" ]; then
|
||||
EXISTING_ENTRY=$(jq -r --arg name "$MCP_NAME" '.mcpServers[$name] // empty' "$CLAUDE_SETTINGS" 2>/dev/null || true)
|
||||
if [ -n "$EXISTING_ENTRY" ]; then
|
||||
MCP_CONFIG_FILE="$CLAUDE_SETTINGS"
|
||||
fi
|
||||
fi
|
||||
|
||||
# Check ~/.claude.json
|
||||
if [ -z "$EXISTING_ENTRY" ] && [ -f "$CLAUDE_JSON" ]; then
|
||||
EXISTING_ENTRY=$(jq -r --arg name "$MCP_NAME" '.mcpServers[$name] // empty' "$CLAUDE_JSON" 2>/dev/null || true)
|
||||
if [ -n "$EXISTING_ENTRY" ]; then
|
||||
MCP_CONFIG_FILE="$CLAUDE_JSON"
|
||||
fi
|
||||
fi
|
||||
|
||||
# Check for project-level .mcp.json files
|
||||
FOUND_PROJECT_MCP=()
|
||||
while IFS= read -r -d '' mcp_file; do
|
||||
if jq -e --arg name "$MCP_NAME" '.mcpServers[$name] != null' "$mcp_file" &>/dev/null; then
|
||||
FOUND_PROJECT_MCP+=("$mcp_file")
|
||||
fi
|
||||
done < <(find "$HOME" -maxdepth 3 -name ".mcp.json" \
|
||||
-not -path "*/.claude/*" \
|
||||
-not -path "*/.gitea-mcp/*" \
|
||||
-not -path "*/node_modules/*" \
|
||||
-print0 2>/dev/null || true)
|
||||
|
||||
# ── Step 4: Migrate / deduplicate ──────────────────────────────────────────
|
||||
|
||||
# If found in project-level files, migrate to global
|
||||
if [ ${#FOUND_PROJECT_MCP[@]} -gt 0 ]; then
|
||||
for mcp_file in "${FOUND_PROJECT_MCP[@]}"; do
|
||||
warn "Found '$MCP_NAME' in project-level config: $mcp_file"
|
||||
|
||||
if [ -z "$EXISTING_ENTRY" ]; then
|
||||
# No global config yet - migrate from project file
|
||||
if ask_yes_no " Migrate to global config ($CLAUDE_SETTINGS)?"; then
|
||||
EXISTING_ENTRY=$(jq --arg name "$MCP_NAME" '.mcpServers[$name]' "$mcp_file")
|
||||
MCP_CONFIG_FILE="$CLAUDE_SETTINGS"
|
||||
fi
|
||||
fi
|
||||
|
||||
# Remove from project-level regardless
|
||||
if ask_yes_no " Remove duplicate from $mcp_file?"; then
|
||||
tmp=$(jq --arg name "$MCP_NAME" 'del(.mcpServers[$name])' "$mcp_file")
|
||||
echo "$tmp" > "$mcp_file"
|
||||
ok "Removed from $mcp_file"
|
||||
fi
|
||||
done
|
||||
fi
|
||||
|
||||
# ── Step 5: Configure default server ───────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
|
||||
# Extract existing values if we have a config
|
||||
CURRENT_HOST=""
|
||||
CURRENT_TOKEN=""
|
||||
CURRENT_SERVERS=""
|
||||
|
||||
if [ -n "$EXISTING_ENTRY" ]; then
|
||||
CURRENT_HOST=$(echo "$EXISTING_ENTRY" | jq -r '
|
||||
(.args // []) | to_entries |
|
||||
map(select(.value == "--host")) | first |
|
||||
if . then (.key + 1) as $k | input | .[$k] else empty end
|
||||
' 2>/dev/null || true)
|
||||
# Simpler extraction
|
||||
CURRENT_HOST=$(echo "$EXISTING_ENTRY" | jq -r '
|
||||
.args as $a | ($a | index("--host")) as $i |
|
||||
if $i then $a[$i + 1] else "" end
|
||||
' 2>/dev/null || true)
|
||||
CURRENT_TOKEN=$(echo "$EXISTING_ENTRY" | jq -r '.env.GITEA_ACCESS_TOKEN // ""' 2>/dev/null || true)
|
||||
CURRENT_SERVERS=$(echo "$EXISTING_ENTRY" | jq -r '.env.GITEA_SERVERS // ""' 2>/dev/null || true)
|
||||
|
||||
ok "Existing config found"
|
||||
echo " Default: ${CURRENT_HOST:-not set}"
|
||||
if [ -n "$CURRENT_SERVERS" ] && [ "$CURRENT_SERVERS" != "" ]; then
|
||||
echo "$CURRENT_SERVERS" | jq -r 'to_entries[] | " \(.key): \(.value.host)"' 2>/dev/null || true
|
||||
fi
|
||||
fi
|
||||
|
||||
# Determine default host and token (env vars > existing > prompt)
|
||||
DEFAULT_HOST="${GITEA_DEFAULT_HOST:-$CURRENT_HOST}"
|
||||
DEFAULT_TOKEN="${GITEA_DEFAULT_TOKEN:-$CURRENT_TOKEN}"
|
||||
|
||||
if [ -z "$DEFAULT_HOST" ]; then
|
||||
info "No default Gitea server configured."
|
||||
ask_input " Default Gitea host URL" DEFAULT_HOST "https://gitea.com"
|
||||
ask_input " Access token" DEFAULT_TOKEN ""
|
||||
fi
|
||||
|
||||
if [ -z "$DEFAULT_TOKEN" ]; then
|
||||
warn "No access token for $DEFAULT_HOST"
|
||||
ask_input " Access token" DEFAULT_TOKEN ""
|
||||
fi
|
||||
|
||||
# ── Step 6: Add additional servers ─────────────────────────────────────────
|
||||
|
||||
SERVERS_JSON="${CURRENT_SERVERS:-}"
|
||||
|
||||
while true; do
|
||||
echo ""
|
||||
if ! ask_yes_no "Add an additional Gitea server?"; then
|
||||
break
|
||||
fi
|
||||
|
||||
srv_name="" srv_host="" srv_token="" srv_insecure="false"
|
||||
ask_input " Server name (e.g. prod, staging)" srv_name ""
|
||||
if [ -z "$srv_name" ]; then break; fi
|
||||
|
||||
# Check if already exists
|
||||
if [ -n "$SERVERS_JSON" ] && echo "$SERVERS_JSON" | jq -e --arg n "$srv_name" '.[$n]' &>/dev/null; then
|
||||
existing_host=$(echo "$SERVERS_JSON" | jq -r --arg n "$srv_name" '.[$n].host')
|
||||
warn "Server '$srv_name' already configured: $existing_host"
|
||||
if ! ask_yes_no " Overwrite?"; then continue; fi
|
||||
fi
|
||||
|
||||
ask_input " Host URL" srv_host ""
|
||||
ask_input " Access token" srv_token ""
|
||||
ask_input " Skip TLS verification? (y/n)" srv_insecure "n"
|
||||
[[ "$srv_insecure" =~ ^[Yy] ]] && srv_insecure="true" || srv_insecure="false"
|
||||
|
||||
if [ -z "$SERVERS_JSON" ] || [ "$SERVERS_JSON" = "" ]; then
|
||||
SERVERS_JSON="{}"
|
||||
fi
|
||||
SERVERS_JSON=$(echo "$SERVERS_JSON" | jq \
|
||||
--arg n "$srv_name" --arg h "$srv_host" --arg t "$srv_token" --argjson i "$srv_insecure" \
|
||||
'.[$n] = {host: $h, token: $t, insecure: $i}')
|
||||
|
||||
ok "Added server '$srv_name': $srv_host"
|
||||
done
|
||||
|
||||
# ── Step 7: Write global MCP config ───────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
info "Writing global MCP configuration..."
|
||||
|
||||
# Build the MCP entry
|
||||
if [ -n "$SERVERS_JSON" ] && [ "$SERVERS_JSON" != "{}" ] && [ "$SERVERS_JSON" != "" ]; then
|
||||
MCP_ENTRY=$(jq -n \
|
||||
--arg cmd "$BINARY_PATH" \
|
||||
--arg host "$DEFAULT_HOST" \
|
||||
--arg token "$DEFAULT_TOKEN" \
|
||||
--arg servers "$SERVERS_JSON" \
|
||||
'{
|
||||
command: $cmd,
|
||||
args: ["-t", "stdio", "--host", $host],
|
||||
env: {
|
||||
GITEA_ACCESS_TOKEN: $token,
|
||||
GITEA_SERVERS: $servers
|
||||
}
|
||||
}')
|
||||
else
|
||||
MCP_ENTRY=$(jq -n \
|
||||
--arg cmd "$BINARY_PATH" \
|
||||
--arg host "$DEFAULT_HOST" \
|
||||
--arg token "$DEFAULT_TOKEN" \
|
||||
'{
|
||||
command: $cmd,
|
||||
args: ["-t", "stdio", "--host", $host],
|
||||
env: {
|
||||
GITEA_ACCESS_TOKEN: $token
|
||||
}
|
||||
}')
|
||||
fi
|
||||
|
||||
# Write to settings.json (global/user level)
|
||||
mkdir -p "$(dirname "$CLAUDE_SETTINGS")"
|
||||
if [ ! -f "$CLAUDE_SETTINGS" ]; then
|
||||
echo '{}' > "$CLAUDE_SETTINGS"
|
||||
fi
|
||||
|
||||
tmp=$(jq --arg name "$MCP_NAME" --argjson entry "$MCP_ENTRY" \
|
||||
'.mcpServers[$name] = $entry' "$CLAUDE_SETTINGS")
|
||||
echo "$tmp" > "$CLAUDE_SETTINGS"
|
||||
ok "Written to $CLAUDE_SETTINGS"
|
||||
|
||||
# Also register via claude CLI if available (belt and suspenders)
|
||||
if command -v claude &>/dev/null; then
|
||||
# Check if claude mcp already has this entry to avoid duplicates
|
||||
if claude mcp list 2>/dev/null | grep -q "$MCP_NAME"; then
|
||||
claude mcp remove "$MCP_NAME" --scope user 2>/dev/null || true
|
||||
fi
|
||||
fi
|
||||
|
||||
# ── Step 8: Clean up duplicates in other config files ──────────────────────
|
||||
|
||||
echo ""
|
||||
info "Checking for duplicate configs..."
|
||||
|
||||
# Clean from project-level .mcp.json files
|
||||
while IFS= read -r -d '' mcp_file; do
|
||||
if jq -e --arg name "$MCP_NAME" '.mcpServers[$name] != null' "$mcp_file" &>/dev/null; then
|
||||
warn "Duplicate found in $mcp_file"
|
||||
if ask_yes_no " Remove '$MCP_NAME' from $mcp_file?"; then
|
||||
tmp=$(jq --arg name "$MCP_NAME" 'del(.mcpServers[$name])' "$mcp_file")
|
||||
echo "$tmp" > "$mcp_file"
|
||||
ok "Removed"
|
||||
fi
|
||||
fi
|
||||
done < <(find "$HOME" -maxdepth 3 -name ".mcp.json" \
|
||||
-not -path "*/.claude/*" \
|
||||
-not -path "*/.gitea-mcp/*" \
|
||||
-not -path "*/node_modules/*" \
|
||||
-print0 2>/dev/null || true)
|
||||
|
||||
# Clean from ~/.claude.json if we wrote to settings.json
|
||||
if [ -f "$CLAUDE_JSON" ]; then
|
||||
if jq -e --arg name "$MCP_NAME" '.mcpServers[$name] != null' "$CLAUDE_JSON" &>/dev/null; then
|
||||
warn "Duplicate found in $CLAUDE_JSON"
|
||||
if ask_yes_no " Remove from $CLAUDE_JSON? (already in settings.json)"; then
|
||||
tmp=$(jq --arg name "$MCP_NAME" 'del(.mcpServers[$name])' "$CLAUDE_JSON")
|
||||
echo "$tmp" > "$CLAUDE_JSON"
|
||||
ok "Removed"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
# ── Done ───────────────────────────────────────────────────────────────────
|
||||
|
||||
echo ""
|
||||
echo -e "${CYAN}=== Configured Servers ===${NC}"
|
||||
echo " default: $DEFAULT_HOST"
|
||||
if [ -n "$SERVERS_JSON" ] && [ "$SERVERS_JSON" != "{}" ] && [ "$SERVERS_JSON" != "" ]; then
|
||||
echo "$SERVERS_JSON" | jq -r 'to_entries[] | " \(.key): \(.value.host)\(if .value.insecure then " (insecure)" else "" end)"'
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}=== Installation complete! ===${NC}"
|
||||
echo ""
|
||||
echo " Binary: $BINARY_PATH ($VERSION)"
|
||||
echo " Config: $CLAUDE_SETTINGS"
|
||||
echo " Source: $INSTALL_DIR"
|
||||
echo ""
|
||||
echo "Restart Claude Code to load the new MCP server."
|
||||
echo ""
|
||||
echo "To upgrade later:"
|
||||
echo " curl -fsSL https://gitea.dev.marcus-law.co.il/Chaim/gitea-mcp/raw/branch/main/install.sh | bash"
|
||||
echo ""
|
||||
Reference in New Issue
Block a user