acuity-mcp-server 1.0.2 → 1.0.3

package/bin/acuity-mcp.cjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+// Cross-platform launcher for Acuity MCP Server
+// Uses only CommonJS syntax compatible with Node 10+
+// No npm dependencies - just spawns the platform-specific script
+
+var spawn = require('child_process').spawn;
+var path = require('path');
+var os = require('os');
+var fs = require('fs');
+
+var scriptDir = __dirname;
+var isWindows = os.platform() === 'win32';
+
+var script = isWindows
+  ? path.join(scriptDir, 'acuity-mcp.cmd')
+  : path.join(scriptDir, 'acuity-mcp.sh');
+
+// Check if script exists
+if (!fs.existsSync(script)) {
+  console.error('Error: Could not find launcher script:', script);
+  process.exit(1);
+}
+
+// Spawn the platform-specific script
+var child = spawn(script, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: isWindows
+});
+
+child.on('error', function(err) {
+  console.error('Error starting Acuity MCP Server:', err.message);
+  process.exit(1);
+});
+
+child.on('exit', function(code) {
+  process.exit(code || 0);
+});

package/bin/acuity-mcp.cmd

@@ -0,0 +1,109 @@
+@echo off
+setlocal enabledelayedexpansion
+
+:: Acuity MCP Server - Auto Node Finder for Windows
+:: Automatically finds Node.js 20+ and runs the MCP server
+
+set "SCRIPT_DIR=%~dp0"
+set "SERVER_JS=%SCRIPT_DIR%..\dist\main.js"
+set "MIN_NODE_VERSION=20"
+set "NODE_BIN="
+
+:: Check nvm-windows
+if exist "%USERPROFILE%\.nvm" (
+    for /d %%d in ("%USERPROFILE%\.nvm\v2*") do (
+        if exist "%%d\node.exe" (
+            call :check_version "%%d\node.exe"
+            if defined NODE_BIN goto :run_server
+        )
+    )
+)
+
+:: Check fnm
+if exist "%USERPROFILE%\.fnm\node-versions" (
+    for /d %%d in ("%USERPROFILE%\.fnm\node-versions\v2*") do (
+        if exist "%%d\installation\node.exe" (
+            call :check_version "%%d\installation\node.exe"
+            if defined NODE_BIN goto :run_server
+        )
+    )
+)
+
+:: Check volta
+if exist "%USERPROFILE%\.volta\bin\node.exe" (
+    call :check_version "%USERPROFILE%\.volta\bin\node.exe"
+    if defined NODE_BIN goto :run_server
+)
+
+:: Check Program Files
+if exist "C:\Program Files\nodejs\node.exe" (
+    call :check_version "C:\Program Files\nodejs\node.exe"
+    if defined NODE_BIN goto :run_server
+)
+
+:: Check PATH
+where node >nul 2>&1
+if %errorlevel% equ 0 (
+    for /f "tokens=*" %%i in ('where node') do (
+        call :check_version "%%i"
+        if defined NODE_BIN goto :run_server
+    )
+)
+
+:: No suitable Node found
+goto :show_error
+
+:check_version
+set "test_node=%~1"
+for /f "tokens=1 delims=v." %%v in ('"%test_node%" -v 2^>nul') do (
+    set "ver=%%v"
+)
+:: Remove 'v' prefix if present
+set "ver=%ver:v=%"
+if defined ver (
+    if %ver% geq %MIN_NODE_VERSION% (
+        set "NODE_BIN=%test_node%"
+    )
+)
+goto :eof
+
+:run_server
+"%NODE_BIN%" "%SERVER_JS%" %*
+goto :end
+
+:show_error
+echo.
+echo ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+echo ERROR: Node.js 20 or higher is required to run Acuity MCP Server
+echo ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+echo.
+echo    Required: ^>= 20.0.0
+echo.
+echo ━━━ How to install Node.js 20+ ━━━
+echo.
+echo    Option 1 - winget:
+echo    ^> winget install OpenJS.NodeJS.LTS
+echo.
+echo    Option 2 - Official installer:
+echo    https://nodejs.org/en/download/
+echo.
+echo ━━━ Already have Node 20+ installed? ━━━
+echo.
+echo    The script searched these locations:
+echo    * %%USERPROFILE%%\.nvm\
+echo    * %%USERPROFILE%%\.fnm\node-versions\
+echo    * %%USERPROFILE%%\.volta\bin\
+echo    * C:\Program Files\nodejs\
+echo    * PATH environment variable
+echo.
+echo    If Node 20+ is installed elsewhere, add PATH to Claude Desktop config:
+echo    %%APPDATA%%\Claude\claude_desktop_config.json
+echo.
+echo    "env": {
+echo      "PATH": "C:\path\to\node;%%PATH%%"
+echo    }
+echo.
+exit /b 1
+
+:end
+endlocal

package/bin/acuity-mcp.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+
+# Acuity MCP Server - Auto Node Finder
+# Automatically finds Node.js 20+ and runs the MCP server
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SERVER_JS="$SCRIPT_DIR/../dist/main.js"
+MIN_NODE_VERSION=20
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Check if a node binary is version 20+
+check_node_version() {
+  local node_bin="$1"
+  if [ -x "$node_bin" ]; then
+    local version=$("$node_bin" -v 2>/dev/null | sed 's/v//' | cut -d. -f1)
+    if [ -n "$version" ] && [ "$version" -ge "$MIN_NODE_VERSION" ]; then
+      echo "$node_bin"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+# Find Node.js 20+ in various locations
+find_node() {
+  # 1. Check nvm versions (most common for developers)
+  if [ -d "$HOME/.nvm/versions/node" ]; then
+    for dir in $(ls -d "$HOME/.nvm/versions/node"/v[2-9][0-9]* 2>/dev/null | sort -rV); do
+      local node_bin="$dir/bin/node"
+      if result=$(check_node_version "$node_bin"); then
+        echo "$result"
+        return 0
+      fi
+    done
+  fi
+
+  # 2. Check fnm versions (fast node manager)
+  if [ -d "$HOME/.fnm/node-versions" ]; then
+    for dir in $(ls -d "$HOME/.fnm/node-versions"/v[2-9][0-9]* 2>/dev/null | sort -rV); do
+      local node_bin="$dir/installation/bin/node"
+      if result=$(check_node_version "$node_bin"); then
+        echo "$result"
+        return 0
+      fi
+    done
+  fi
+
+  # 3. Check volta
+  if [ -d "$HOME/.volta/bin" ]; then
+    local node_bin="$HOME/.volta/bin/node"
+    if result=$(check_node_version "$node_bin"); then
+      echo "$result"
+      return 0
+    fi
+  fi
+
+  # 4. Check homebrew (macOS)
+  for node_bin in "/opt/homebrew/bin/node" "/usr/local/bin/node"; do
+    if result=$(check_node_version "$node_bin"); then
+      echo "$result"
+      return 0
+    fi
+  done
+
+  # 5. Check common Linux locations
+  for node_bin in "/usr/bin/node" "/usr/local/bin/node"; do
+    if result=$(check_node_version "$node_bin"); then
+      echo "$result"
+      return 0
+    fi
+  done
+
+  # 6. Check PATH as last resort
+  if command -v node &>/dev/null; then
+    local node_bin=$(command -v node)
+    if result=$(check_node_version "$node_bin"); then
+      echo "$result"
+      return 0
+    fi
+  fi
+
+  return 1
+}
+
+# Show error message with install instructions
+show_error() {
+  local current_version="$1"
+
+  echo -e "\n${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${RED}❌ ERROR: Node.js 20 or higher is required to run Acuity MCP Server${NC}"
+  echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}\n"
+
+  if [ -n "$current_version" ]; then
+    echo -e "   Found Node.js: ${YELLOW}$current_version${NC} (too old)"
+  else
+    echo -e "   ${YELLOW}No Node.js found${NC}"
+  fi
+  echo -e "   Required:      ${GREEN}>= 20.0.0${NC}\n"
+
+  echo -e "${CYAN}━━━ How to install Node.js 20+ ━━━${NC}\n"
+
+  # Detect OS
+  case "$(uname -s)" in
+    Darwin)
+      echo -e "${YELLOW}📦 macOS:${NC}\n"
+      echo "   Option 1 - Homebrew (recommended):"
+      echo -e "   ${GREEN}$ brew install node@22${NC}\n"
+      echo "   Option 2 - Official installer:"
+      echo -e "   \033[4mhttps://nodejs.org/en/download/\033[0m\n"
+      ;;
+    Linux)
+      echo -e "${YELLOW}📦 Linux:${NC}\n"
+      echo "   Option 1 - NodeSource (recommended):"
+      echo -e "   ${GREEN}$ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -${NC}"
+      echo -e "   ${GREEN}$ sudo apt-get install -y nodejs${NC}\n"
+      echo "   Option 2 - Official binaries:"
+      echo -e "   \033[4mhttps://nodejs.org/en/download/\033[0m\n"
+      ;;
+  esac
+
+  echo -e "${CYAN}━━━ Already have Node 20+ installed? ━━━${NC}\n"
+  echo "   The script searched these locations:"
+  echo "   • ~/.nvm/versions/node/"
+  echo "   • ~/.fnm/node-versions/"
+  echo "   • ~/.volta/bin/"
+  echo "   • /opt/homebrew/bin/"
+  echo "   • /usr/local/bin/"
+  echo "   • /usr/bin/"
+  echo ""
+  echo "   If Node 20+ is installed elsewhere, add PATH to Claude Desktop config:"
+  echo -e "   ${YELLOW}~/Library/Application Support/Claude/claude_desktop_config.json${NC}\n"
+  echo -e "   ${GREEN}\"env\": {"
+  echo "     \"PATH\": \"/path/to/node/bin:/usr/bin:/bin\""
+  echo -e "   }${NC}\n"
+}
+
+# Main
+NODE_BIN=$(find_node)
+
+if [ -z "$NODE_BIN" ]; then
+  # Try to get current node version for error message
+  if command -v node &>/dev/null; then
+    current=$(node -v 2>/dev/null)
+  fi
+  show_error "$current"
+  exit 1
+fi
+
+# Run the server with found Node
+exec "$NODE_BIN" "$SERVER_JS" "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acuity-mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MCP server for Acuity Project Management - enables LLM access to project data",
   "engines": {
     "node": ">=20"
@@ -8,9 +8,10 @@
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "acuity-mcp-server": "./dist/index.js"
+    "acuity-mcp-server": "./bin/acuity-mcp.cjs"
   },
   "files": [
+    "bin",
     "dist",
     "!dist/**/__tests__",
     "openapi.yaml",