@hybridlabor-api/bdb-hardware-pcb 0.1.0

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@hybridlabor-api/bdb-hardware-pcb",
+  "version": "0.1.0",
+  "description": "BDB Hardware & PCB — KiCad + OpenSCAD MCP servers and AI-era skills for schematic capture, PCB layout/routing, DFM sign-off, and parametric 3D enclosure design",
+  "main": "installer.js",
+  "bin": {
+    "bdb-hardware-pcb": "installer.js"
+  },
+  "scripts": {
+    "test": "./scripts/test_mcp_connection.sh --all"
+  },
+  "files": [
+    "skills",
+    "mcp_servers",
+    "scripts",
+    "config",
+    "docs",
+    "installer.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hybridlabor-api/bdb-hardware-pcb.git"
+  },
+  "keywords": [
+    "bdb",
+    "kicad",
+    "openscad",
+    "pcb",
+    "mcp",
+    "hardware",
+    "electrical-engineering",
+    "mcp-server"
+  ],
+  "author": "hybridlabor-api",
+  "license": "Apache-2.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/scripts/install_mcps.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# AOS Hardware MCP Server Installation & Setup Script
+# ==============================================================================
+# Sets up virtual environments and dependencies for KiCad and OpenSCAD MCP
+# servers, verifies host prerequisites, configures executable permissions,
+# exports lazy tool schemas, and validates connections.
+# ==============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+echo "================================================================================"
+echo "🛠️  AOS Hardware MCP Server Setup & Installer"
+echo "================================================================================"
+
+# 1. Ensure scripts are executable
+chmod +x "${SCRIPT_DIR}/"*.sh 2>/dev/null || true
+
+# 2. Check for uv or python3
+UV_BIN=""
+if command -v uv >/dev/null 2>&1; then
+    UV_BIN="uv"
+elif [[ -x "${HOME}/.local/bin/uv" ]]; then
+    UV_BIN="${HOME}/.local/bin/uv"
+fi
+
+if [[ -z "${UV_BIN}" ]]; then
+    echo "⚠️  'uv' not found. Checking python3..."
+    if ! command -v python3 >/dev/null 2>&1; then
+        echo "❌ Error: python3 is required." >&2
+        exit 1
+    fi
+fi
+
+# 3. Synchronize KiCad MCP Server dependencies
+echo ""
+echo "[1/4] Installing KiCad MCP Server dependencies..."
+KICAD_DIR="${REPO_DIR}/mcp_servers/kicad-mcp-server"
+if [[ -n "${UV_BIN}" ]]; then
+    (cd "${KICAD_DIR}" && "${UV_BIN}" sync)
+else
+    (cd "${KICAD_DIR}" && python3 -m venv .venv && .venv/bin/pip install -e .)
+fi
+echo "      ✓ KiCad MCP Server ready."
+
+# 4. Synchronize OpenSCAD MCP Server dependencies
+echo ""
+echo "[2/4] Installing OpenSCAD MCP Server dependencies..."
+OPENSCAD_DIR="${REPO_DIR}/mcp_servers/openscad-mcp-server"
+if [[ -n "${UV_BIN}" ]]; then
+    (cd "${OPENSCAD_DIR}" && "${UV_BIN}" sync)
+else
+    (cd "${OPENSCAD_DIR}" && python3 -m venv .venv && .venv/bin/pip install -e .)
+fi
+echo "      ✓ OpenSCAD MCP Server ready."
+
+# 5. Check host CAD prerequisites
+echo ""
+echo "[3/4] Checking host CAD prerequisites..."
+if command -v kicad-cli >/dev/null 2>&1 || [[ -x "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli" ]]; then
+    echo "      ✓ KiCad CLI detected on host."
+else
+    echo "      ℹ️  KiCad is not yet installed on host."
+    echo "         To install on macOS, run: brew install --cask kicad"
+fi
+
+if command -v openscad >/dev/null 2>&1 || [[ -x "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD" ]]; then
+    echo "      ✓ OpenSCAD binary detected on host."
+else
+    echo "      ℹ️  OpenSCAD is not yet installed on host (fallback shim active)."
+    echo "         To install on macOS, run: brew install --cask openscad@snapshot"
+fi
+
+# 6. Export Antigravity lazy schemas and run verification
+echo ""
+echo "[4/4] Generating Antigravity lazy tool schemas & running verification..."
+ANTIGRAVITY_DIR="${HOME}/.gemini/antigravity-cli/mcp"
+python3 "${SCRIPT_DIR}/test_mcp_connection.py" --export-antigravity "${ANTIGRAVITY_DIR}"
+
+echo ""
+echo "================================================================================"
+echo "✅ AOS Hardware MCP Installation & Verification Complete!"
+echo "================================================================================"

package/scripts/openscad_wrapper.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# AOS OpenSCAD Wrapper & Fallback Shim
+# ==============================================================================
+# Detects host OpenSCAD installation. If found, delegates all calls to the real
+# binary. If not found, provides an automated fallback shim for version checks
+# and clear instructions for rendering operations.
+# ==============================================================================
+
+set -euo pipefail
+
+REAL_OPENSCAD=""
+
+# 1. Check OPENSCAD_PATH environment variable if set
+if [[ -n "${OPENSCAD_PATH:-}" && -x "${OPENSCAD_PATH}" ]]; then
+    REAL_OPENSCAD="${OPENSCAD_PATH}"
+fi
+
+# 2. Check standard macOS application locations
+if [[ -z "${REAL_OPENSCAD}" ]]; then
+    for candidate in \
+        "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD" \
+        "/Applications/OpenSCAD-2021.01.app/Contents/MacOS/OpenSCAD" \
+        "/opt/homebrew/bin/openscad" \
+        "/usr/local/bin/openscad"; do
+        if [[ -x "${candidate}" ]]; then
+            REAL_OPENSCAD="${candidate}"
+            break
+        fi
+    done
+fi
+
+# 3. Check PATH (avoiding recursing on this wrapper script)
+if [[ -z "${REAL_OPENSCAD}" ]]; then
+    SELF_PATH="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")"
+    while IFS= read -r p; do
+        if [[ -x "$p" && "$p" != "$SELF_PATH" ]]; then
+            REAL_OPENSCAD="$p"
+            break
+        fi
+    done < <(which -a openscad 2>/dev/null || true)
+fi
+
+# If real OpenSCAD was found, forward directly to it
+if [[ -n "${REAL_OPENSCAD}" ]]; then
+    exec "${REAL_OPENSCAD}" "$@"
+fi
+
+# Fallback handling when OpenSCAD is not yet installed on host
+if [[ "$*" == *"--version"* ]]; then
+    echo "OpenSCAD Version 2026.09.06 (AOS Managed Shim; Host OpenSCAD not detected - run 'brew install --cask openscad@snapshot')"
+    exit 0
+fi
+
+# If geometry generation / rendering is requested without OpenSCAD installed:
+echo "================================================================================" >&2
+echo "[AOS OpenSCAD Wrapper] Error: OpenSCAD binary not detected on host." >&2
+echo "To enable 3D STL/PNG/CSG rendering, install OpenSCAD on macOS via:" >&2
+echo "    brew install --cask openscad@snapshot" >&2
+echo "Or specify OPENSCAD_EXECUTABLE to a custom binary location." >&2
+echo "================================================================================" >&2
+exit 1

package/scripts/run_kicad_mcp.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# AOS KiCad MCP Server Runner
+# ==============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+SERVER_DIR="${REPO_DIR}/mcp_servers/kicad-mcp-server"
+
+# Export default KiCad CLI path if not set
+export KICAD_CLI_PATH="${KICAD_CLI_PATH:-/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli}"
+export PYTHONPATH="${SERVER_DIR}/src:${PYTHONPATH:-}"
+
+# Locate virtual environment or uv
+VENV_BIN="${SERVER_DIR}/.venv/bin/kicad-mcp-server"
+if [[ -x "${VENV_BIN}" ]]; then
+    CMD=("${VENV_BIN}")
+elif command -v uv >/dev/null 2>&1; then
+    CMD=("uv" "run" "--project" "${SERVER_DIR}" "kicad-mcp-server")
+else
+    CMD=("python3" "-m" "kicad_mcp_server")
+fi
+
+exec "${CMD[@]}" "$@"

package/scripts/run_openscad_mcp.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# AOS OpenSCAD MCP Server Runner
+# ==============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+SERVER_DIR="${REPO_DIR}/mcp_servers/openscad-mcp-server"
+
+# Ensure wrapper script is executable
+chmod +x "${SCRIPT_DIR}/openscad_wrapper.sh" 2>/dev/null || true
+
+# Set OpenSCAD executable environment variable if not already explicitly set
+export OPENSCAD_EXECUTABLE="${OPENSCAD_EXECUTABLE:-${SCRIPT_DIR}/openscad_wrapper.sh}"
+export PYTHONPATH="${SERVER_DIR}/src:${PYTHONPATH:-}"
+
+# Locate virtual environment or uv
+VENV_BIN="${SERVER_DIR}/.venv/bin/openscad-mcp"
+if [[ -x "${VENV_BIN}" ]]; then
+    CMD=("${VENV_BIN}")
+elif command -v uv >/dev/null 2>&1; then
+    CMD=("uv" "run" "--project" "${SERVER_DIR}" "openscad-mcp")
+else
+    CMD=("python3" "-m" "openscad_mcp.server")
+fi
+
+# Default to stdio transport if not specified
+HAS_TRANSPORT=0
+for arg in "$@"; do
+    if [[ "$arg" == "--transport" ]]; then
+        HAS_TRANSPORT=1
+        break
+    fi
+done
+
+if [[ $HAS_TRANSPORT -eq 0 ]]; then
+    exec "${CMD[@]}" --transport stdio "$@"
+else
+    exec "${CMD[@]}" "$@"
+fi