Gitea MCP Tool

#!/bin/bash # Gitea MCP Server - Quick Installation (Download Release) # Downloads and installs pre-built release package set -e # Colors RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' CYAN='\033[0;36m' NC='\033[0m' # 检查并修复工作目录（必须在脚本最开始执行） fix_working_directory() { local current_dir # 尝试获取当前目录的真实路径 if ! current_dir=$(pwd -P 2>/dev/null); then # 如果无法获取当前目录，切换到 HOME cd "${HOME}" 2>/dev/null || cd /tmp return fi # 检查目录是否真实存在（防止目录被删除但 shell 仍在其中） if [ ! -d "$current_dir" ]; then cd "${HOME}" 2>/dev/null || cd /tmp fi } # 立即执行目录检查 fix_working_directory # 默认语言（根据系统环境检测） LANG_DEFAULT="zh" if [[ "${LANG}" != *"zh"* ]] && [[ "${LANG}" != *"CN"* ]]; then LANG_DEFAULT="en" fi INSTALL_LANG="${INSTALL_LANG:-$LANG_DEFAULT}" # 多语言文本函数（兼容 bash 3.2+） get_text() { local key="$1" local lang="${INSTALL_LANG:-zh}" case "$key" in TITLE) if [ "$lang" = "zh" ]; then echo "Gitea MCP Server - 快速安装" else echo "Gitea MCP Server - Quick Installation" fi ;; LANG_SELECT) if [ "$lang" = "zh" ]; then echo "请选择语言 / Select Language" else echo "Please select language / 请选择语言" fi ;; VERSION_INFO) if [ "$lang" = "zh" ]; then echo "版本信息" else echo "Version Information" fi ;; CURRENT_VERSION) if [ "$lang" = "zh" ]; then echo "当前已安装版本" else echo "Currently Installed Version" fi ;; LATEST_VERSION) if [ "$lang" = "zh" ]; then echo "最新可用版本" else echo "Latest Available Version" fi ;; NOT_INSTALLED) if [ "$lang" = "zh" ]; then echo "未安装" else echo "Not installed" fi ;; INSTALL_TYPE) if [ "$lang" = "zh" ]; then echo "请选择安装类型" else echo "Please select installation type" fi ;; INSTALL_MCP) if [ "$lang" = "zh" ]; then echo "仅安装 MCP Server（供 AI 工具使用）" else echo "MCP Server only (for AI tools)" fi ;; INSTALL_CLI) if [ "$lang" = "zh" ]; then echo "仅安装 CLI 工具（keactl 命令行）" else echo "CLI tool only (keactl command line)" fi ;; INSTALL_ALL) if [ "$lang" = "zh" ]; then echo "安装全部（MCP + CLI）" else echo "Install both (MCP + CLI)" fi ;; CHECKING_NODE) if [ "$lang" = "zh" ]; then echo "检查 Node.js 环境" else echo "Checking Node.js" fi ;; DOWNLOADING) if [ "$lang" = "zh" ]; then echo "下载发布包" else echo "Downloading release package" fi ;; INSTALLING) if [ "$lang" = "zh" ]; then echo "安装软件包" else echo "Installing package" fi ;; INSTALLING_DEPS) if [ "$lang" = "zh" ]; then echo "安装依赖" else echo "Installing dependencies" fi ;; CONFIGURATION) if [ "$lang" = "zh" ]; then echo "配置说明" else echo "Configuration" fi ;; INSTALL_SUCCESS) if [ "$lang" = "zh" ]; then echo "安装成功完成！" else echo "Installation completed successfully!" fi ;; INSTALL_PATH) if [ "$lang" = "zh" ]; then echo "安装路径" else echo "Installation path" fi ;; NEXT_STEPS) if [ "$lang" = "zh" ]; then echo "后续步骤" else echo "Next steps" fi ;; RUN_WIZARD) if [ "$lang" = "zh" ]; then echo "运行配置向导（推荐）" else echo "Run configuration wizard (recommended)" fi ;; MANUAL_CONFIG) if [ "$lang" = "zh" ]; then echo "或手动配置 MCP 客户端" else echo "Or manually configure your MCP client" fi ;; ASK_WIZARD) if [ "$lang" = "zh" ]; then echo "是否现在运行配置向导来自动配置 MCP 客户端? (y/n)" else echo "Run configuration wizard now to auto-configure MCP clients? (y/n)" fi ;; SKIP_WIZARD) if [ "$lang" = "zh" ]; then echo "跳过配置向导，请参考上方示例手动配置" else echo "Skipped wizard, please configure manually using examples above" fi ;; *) echo "$key" ;; esac } # 日志函数 log_info() { echo -e "${GREEN}[INFO]${NC} $1"; } log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; } log_error() { echo -e "${RED}[ERROR]${NC} $1"; } log_step() { echo -e "${BLUE}[STEP]${NC} $1"; } command_exists() { command -v "$1" >/dev/null 2>&1; } # Configuration GITEA_URL="https://gitea.ktyun.cc" REPO_OWNER="Kysion" REPO_NAME="entai-gitea-mcp" INSTALL_DIR="${HOME}/.gitea-mcp" INSTALL_TYPE="all" # all, mcp, cli VERSION="" CURRENT_INSTALLED_VERSION="" # 语言选择 select_language() { echo "" echo -e "${CYAN}==========================================${NC}" echo -e " $(get_text "LANG_SELECT")" echo -e "${CYAN}==========================================${NC}" echo "" PS3=$'\n'"Please enter (1-2): " select lang in "中文 (Chinese)" "English"; do case $lang in "中文 (Chinese)") INSTALL_LANG="zh" break ;; "English") INSTALL_LANG="en" break ;; *) echo "Invalid option" ;; esac done < /dev/tty } # 获取当前已安装版本 get_installed_version() { if [ -f "${INSTALL_DIR}/package.json" ]; then CURRENT_INSTALLED_VERSION=$(node -p "require('${INSTALL_DIR}/package.json').version" 2>/dev/null || echo "") fi if [ -z "$CURRENT_INSTALLED_VERSION" ]; then CURRENT_INSTALLED_VERSION="$(get_text "NOT_INSTALLED")" fi } # Check for authentication token check_auth() { if [ -z "$GITEA_API_TOKEN" ]; then if [ "$INSTALL_LANG" = "zh" ]; then log_warn "GITEA_API_TOKEN 未设置。如果是私有仓库，下载可能会失败" log_info "认证方式: export GITEA_API_TOKEN=your_token_here" else log_warn "GITEA_API_TOKEN not set. Download may fail for private repositories" log_info "To authenticate: export GITEA_API_TOKEN=your_token_here" fi echo "" else if [ "$INSTALL_LANG" = "zh" ]; then log_info "使用认证访问" else log_info "Using authenticated access" fi fi } # Get latest release version get_latest_version() { if [ "$INSTALL_LANG" = "zh" ]; then log_info "获取最新版本..." else log_info "Fetching latest release version..." fi # 首先尝试从 npm registry 获取最新版本（最可靠的来源） local npm_api_url="https://registry.npmjs.org/gitea-mcp-tool/latest" if command_exists curl; then VERSION=$(curl -s "${npm_api_url}" | grep -o '"version":"[^"]*"' | head -1 | cut -d'"' -f4) elif command_exists wget; then VERSION=$(wget -qO- "${npm_api_url}" | grep -o '"version":"[^"]*"' | head -1 | cut -d'"' -f4) else log_error "Neither curl nor wget is available" exit 1 fi # 如果从 npm 获取成功，添加 v 前缀 if [ -n "$VERSION" ]; then VERSION="v${VERSION}" return fi # 备选方案：尝试从 Gitea releases API 获取 local api_url="${GITEA_URL}/api/v1/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest" local auth_header="" if [ -n "$GITEA_API_TOKEN" ]; then auth_header="Authorization: token ${GITEA_API_TOKEN}" fi if command_exists curl; then if [ -n "$auth_header" ]; then VERSION=$(curl -s -H "${auth_header}" "${api_url}" | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4) else VERSION=$(curl -s "${api_url}" | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4) fi elif command_exists wget; then if [ -n "$auth_header" ]; then VERSION=$(wget -qO- --header="${auth_header}" "${api_url}" | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4) else VERSION=$(wget -qO- "${api_url}" | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4) fi fi if [ -z "$VERSION" ]; then if [ "$INSTALL_LANG" = "zh" ]; then log_warn "无法获取最新版本，使用默认: v1.6.2" else log_warn "Could not fetch latest version, using default: v1.6.2" fi VERSION="v1.6.2" fi } # 显示版本信息 show_version_info() { echo "" echo -e "${CYAN}==========================================${NC}" echo -e " $(get_text "VERSION_INFO")" echo -e "${CYAN}==========================================${NC}" echo "" get_installed_version echo "📦 $(get_text "CURRENT_VERSION"): ${CURRENT_INSTALLED_VERSION}" echo "🌐 $(get_text "LATEST_VERSION"): ${VERSION}" echo "" } # 选择安装类型 select_install_type() { echo "" echo -e "${CYAN}==========================================${NC}" echo -e " $(get_text "INSTALL_TYPE")" echo -e "${CYAN}==========================================${NC}" echo "" PS3=$'\n'"Please enter (1-3): " select type in "$(get_text "INSTALL_MCP")" \ "$(get_text "INSTALL_CLI")" \ "$(get_text "INSTALL_ALL")"; do case $REPLY in 1) INSTALL_TYPE="mcp" break ;; 2) INSTALL_TYPE="cli" break ;; 3) INSTALL_TYPE="all" break ;; *) echo "Invalid option" ;; esac done < /dev/tty } # Check prerequisites check_node() { log_step "1/5 $(get_text "CHECKING_NODE")..." if ! command_exists node; then if [ "$INSTALL_LANG" = "zh" ]; then log_error "Node.js 未安装" log_info "请从以下地址安装 Node.js 18+: https://nodejs.org/" else log_error "Node.js is not installed" log_info "Please install Node.js 18+ from: https://nodejs.org/" fi exit 1 fi local node_version=$(node -v | cut -d'v' -f2 | cut -d'.' -f1) if [ "$node_version" -lt 18 ]; then if [ "$INSTALL_LANG" = "zh" ]; then log_error "Node.js 版本必须 >= 18。当前: $(node -v)" else log_error "Node.js version must be 18+. Current: $(node -v)" fi exit 1 fi log_info "Node.js $(node -v) ✓" if ! command_exists npm; then if [ "$INSTALL_LANG" = "zh" ]; then log_error "npm 未安装" else log_error "npm is not installed" fi exit 1 fi log_info "npm $(npm -v) ✓" } # Download release download_release() { log_step "2/5 $(get_text "DOWNLOADING")..." local package_name="gitea-mcp-${VERSION}.tar.gz" local download_url="${GITEA_URL}/${REPO_OWNER}/${REPO_NAME}/releases/download/${VERSION}/${package_name}" if [ "$INSTALL_LANG" = "zh" ]; then log_info "下载地址: ${download_url}" else log_info "URL: ${download_url}" fi local temp_file="/tmp/${package_name}" local auth_header="" if [ -n "$GITEA_API_TOKEN" ]; then auth_header="Authorization: token ${GITEA_API_TOKEN}" fi if command_exists curl; then if [ -n "$auth_header" ]; then curl -L -H "${auth_header}" -o "${temp_file}" "${download_url}" || { log_error "Download failed" exit 1 } else curl -L -o "${temp_file}" "${download_url}" || { log_error "Download failed" exit 1 } fi elif command_exists wget; then if [ -n "$auth_header" ]; then wget --header="${auth_header}" -O "${temp_file}" "${download_url}" || { log_error "Download failed" exit 1 } else wget -O "${temp_file}" "${download_url}" || { log_error "Download failed" exit 1 } fi fi TEMP_FILE="${temp_file}" if [ "$INSTALL_LANG" = "zh" ]; then log_info "已下载到: ${temp_file}" else log_info "Downloaded to: ${temp_file}" fi } # Install package install_package() { log_step "3/5 $(get_text "INSTALLING")..." # Remove old installation if [ -d "${INSTALL_DIR}" ]; then if [ "$INSTALL_LANG" = "zh" ]; then log_warn "删除旧版本: ${INSTALL_DIR}" else log_warn "Removing old installation: ${INSTALL_DIR}" fi rm -rf "${INSTALL_DIR}" fi mkdir -p "${INSTALL_DIR}" tar -xzf "${TEMP_FILE}" -C "${INSTALL_DIR}" rm -f "${TEMP_FILE}" if [ "$INSTALL_LANG" = "zh" ]; then log_info "已安装到: ${INSTALL_DIR}" else log_info "Installed to: ${INSTALL_DIR}" fi } # Install dependencies install_dependencies() { log_step "4/5 $(get_text "INSTALLING_DEPS")..." cd "${INSTALL_DIR}" if [ "$INSTALL_LANG" = "zh" ]; then log_info "运行 npm install..." else log_info "Running npm install..." fi if npm install --production --silent > /dev/null 2>&1; then if [ "$INSTALL_LANG" = "zh" ]; then log_info "依赖安装完成 ✓" else log_info "Dependencies installed ✓" fi else if [ "$INSTALL_LANG" = "zh" ]; then log_warn "npm install 完成但有警告" else log_warn "npm install completed with warnings" fi fi cd - > /dev/null } # Show configuration show_config() { log_step "5/5 $(get_text "CONFIGURATION")" echo "" log_info "==========================================" log_info "$(get_text "INSTALL_SUCCESS")" log_info "==========================================" echo "" log_info "$(get_text "INSTALL_PATH"):" echo " ${INSTALL_DIR}" echo "" case $INSTALL_TYPE in "mcp") if [ "$INSTALL_LANG" = "zh" ]; then log_info "MCP Server 入口:" echo " ${INSTALL_DIR}/dist/index.js" else log_info "MCP Server entry point:" echo " ${INSTALL_DIR}/dist/index.js" fi ;; "cli") if [ "$INSTALL_LANG" = "zh" ]; then log_info "CLI 工具入口:" echo " ${INSTALL_DIR}/dist/cli/index.js" echo "" log_info "使用方式:" echo " node ${INSTALL_DIR}/dist/cli/index.js --help" else log_info "CLI tool entry point:" echo " ${INSTALL_DIR}/dist/cli/index.js" echo "" log_info "Usage:" echo " node ${INSTALL_DIR}/dist/cli/index.js --help" fi ;; "all") if [ "$INSTALL_LANG" = "zh" ]; then log_info "MCP Server: ${INSTALL_DIR}/dist/index.js" log_info "CLI 工具: ${INSTALL_DIR}/dist/cli/index.js" else log_info "MCP Server: ${INSTALL_DIR}/dist/index.js" log_info "CLI tool: ${INSTALL_DIR}/dist/cli/index.js" fi ;; esac echo "" if [ "$INSTALL_TYPE" = "mcp" ] || [ "$INSTALL_TYPE" = "all" ]; then if [ "$INSTALL_LANG" = "zh" ]; then log_info "配置示例:" else log_info "Configuration examples:" fi echo "" echo " Claude Desktop (~/.../Claude/claude_desktop_config.json):" echo ' {' echo ' "mcpServers": {' echo ' "gitea-mcp-tool": {' echo ' "command": "node",' echo ' "args": ["'${INSTALL_DIR}'/dist/index.js"],' echo ' "env": {' echo ' "GITEA_BASE_URL": "https://gitea.ktyun.cc",' echo ' "GITEA_API_TOKEN": "your_token_here"' echo ' }' echo ' }' echo ' }' echo ' }' echo "" fi log_info "$(get_text "NEXT_STEPS"):" echo " 1. $(get_text "RUN_WIZARD")" echo " 2. $(get_text "MANUAL_CONFIG")" if [ "$INSTALL_LANG" = "zh" ]; then echo " 3. 设置 GITEA_BASE_URL 和 GITEA_API_TOKEN" echo " 4. 重启 MCP 客户端" echo "" log_info "文档: ${INSTALL_DIR}/README.md" log_info "支持: ${GITEA_URL}/${REPO_OWNER}/${REPO_NAME}/issues" else echo " 3. Set GITEA_BASE_URL and GITEA_API_TOKEN" echo " 4. Restart your MCP client" echo "" log_info "Documentation: ${INSTALL_DIR}/README.md" log_info "Support: ${GITEA_URL}/${REPO_OWNER}/${REPO_NAME}/issues" fi echo "" } # 询问是否运行配置向导 ask_configure() { if [ "$INSTALL_TYPE" = "cli" ]; then return fi echo "" read -p "$(echo -e ${BLUE}$(get_text "ASK_WIZARD"):${NC} )" -n 1 -r < /dev/tty echo "" if [[ $REPLY =~ ^[Yy]$ ]]; then if [ "$INSTALL_LANG" = "zh" ]; then log_info "正在下载配置向导..." else log_info "Downloading configuration wizard..." fi local config_script="/tmp/configure-clients-$$.sh" local script_url="${GITEA_URL}/${REPO_OWNER}/${REPO_NAME}/raw/branch/main/configure-clients.sh" local auth_header="" if [ -n "$GITEA_API_TOKEN" ]; then auth_header="Authorization: token ${GITEA_API_TOKEN}" fi if command_exists curl; then if [ -n "$auth_header" ]; then curl -fsSL -H "${auth_header}" "${script_url}" -o "${config_script}" 2>/dev/null || { if [ "$INSTALL_LANG" = "zh" ]; then log_warn "下载配置向导失败，请手动配置" else log_warn "Failed to download wizard, please configure manually" fi return } else curl -fsSL "${script_url}" -o "${config_script}" 2>/dev/null || { if [ "$INSTALL_LANG" = "zh" ]; then log_warn "下载配置向导失败，请手动配置" else log_warn "Failed to download wizard, please configure manually" fi return } fi fi if [ -f "${config_script}" ]; then chmod +x "${config_script}" bash "${config_script}" rm -f "${config_script}" fi else log_info "$(get_text "SKIP_WIZARD")" fi } # Main main() { # 语言选择 select_language echo "" log_info "==========================================" log_info "$(get_text "TITLE")" log_info "==========================================" echo "" check_auth get_latest_version # 显示版本信息 show_version_info # 选择安装类型 select_install_type # 执行安装 check_node download_release install_package install_dependencies show_config ask_configure } main