PRIMS – Python Runtime Interpreter MCP Server

#!/usr/bin/env bash # scripts/setup_env.sh ── quick dev-environment bootstrap # # Usage: # ./scripts/setup_env.sh # creates .venv & installs requirements # source .venv/bin/activate # activate the venv (remember each shell) set -euo pipefail # Determine which Python interpreter to use. # # Priority order: # 1. Respect an explicit $PYTHON environment variable. # 2. If a `python3.13` executable exists in PATH, use that (it is # typically installed alongside other minor versions and avoids any # ambiguity with an older default `python3`). # 3. Fallback to the generic `python3` binary. if [[ -n "${PYTHON:-}" ]]; then PYTHON_BIN="${PYTHON}" else if command -v python3.13 &>/dev/null; then PYTHON_BIN="python3.13" else PYTHON_BIN="python3" fi fi VENV_DIR=".venv" # Require Python ≥ 3.13 REQ_MAJOR=3 REQ_MINOR=13 # Helper: ensure a command exists have() { command -v "$1" &>/dev/null; } if ! have "$PYTHON_BIN"; then cat >&2 <<EOF [setup] ❌ '$PYTHON_BIN' not found. You need Python 3.13 or newer installed and discoverable in PATH. Recommended installation methods: • macOS : brew install python@3.13 • Ubuntu : sudo apt-get install python3.13 python3.13-venv • Fedora : sudo dnf install python3.13 python3.13-venv • Windows : winget install --id Python.Python.3.13 (or use the official installer) Alternatively use pyenv: curl https://pyenv.run | bash pyenv install 3.13.0 && pyenv local 3.13.0 Set the environment variable PYTHON to point at the 3.13 interpreter if it is not named 'python3'. EOF exit 1 fi # Check interpreter version CURRENT=$("$PYTHON_BIN" -V 2>&1 | awk '{print $2}') MAJOR=${CURRENT%%.*} MINOR=$(echo "$CURRENT" | cut -d. -f2) if (( MAJOR < REQ_MAJOR || ( MAJOR == REQ_MAJOR && MINOR < REQ_MINOR ) )); then cat >&2 <<EOF [setup] ❌ Python 3.13+ required, but '$PYTHON_BIN' is $CURRENT. Use pyenv or your OS package manager to install a newer interpreter, then re-run this script. See README for details. EOF exit 1 fi # Create virtual environment if it doesn't exist if [ ! -d "$VENV_DIR" ]; then echo "[setup] Creating virtual environment in $VENV_DIR" "$PYTHON_BIN" -m venv "$VENV_DIR" fi # Activate source "$VENV_DIR/bin/activate" # Upgrade pip & install dependencies pip install --upgrade pip pip install -r requirements.txt echo "[setup] ✅ Environment ready." python -m server.main fastmcp run server/main.py