v1.2.1

🐛 Bug Fixes

Installer no longer blocks when MCPBASH_HOME points elsewhere — the installer previously refused to run whenever MCPBASH_HOME was set, even if it pointed to a vendored runtime (.mcp-bash/) rather than the install target. This was the biggest pain point for CI workflows that need both a vendored runtime and the full CLI. The check now only blocks when MCPBASH_HOME matches the install directory.

Installer verification works with MCPBASH_HOME in the environment — even after the check was relaxed, the installer's mcp-bash --version verification step was inheriting the stale MCPBASH_HOME, causing it to look for libs at the wrong path and report "mcp-bash failed to run." The installer now unsets MCPBASH_HOME before verification.

Vendored runtime gives a clear error for CLI commands — running CLI commands (validate, bundle, doctor, etc.) against a vendored or embedded runtime previously failed with a cryptic "No such file or directory" for the missing lib/cli/*.sh module. The entrypoint now detects missing CLI modules early and prints a helpful message:

Error: "validate" is not available in this installation.
This is a vendored runtime — CLI commands require a full mcp-bash install.

Bundle resolves icons and screenshots paths correctly — paths in the server.meta.json icons and screenshots arrays can now be relative to either the project root (assets/icons/foo.png) or to server.d/ (../assets/icons/foo.png). Previously, only project-root-relative paths worked, so ../ paths written relative to server.d/ would fail with a spurious warning even though the file existed.

📚 Documentation

• docs/VENDORING.md now explicitly lists which CLI commands are not included in vendored copies and notes that the installer won't conflict with a vendored copy
• "Built with mcp-bash" section in README now lists projects using the framework: affinity-sdk, claude-familiar, git-hex

📦 Upgrading

No breaking changes. Drop-in patch release for 1.2.0.

# Homebrew (recommended)
brew upgrade mcp-bash

# Or via curl
curl -fsSL "https://raw.githubusercontent.com/yaniv-golan/mcp-bash-framework/v1.2.1/install.sh" | bash -s -- --yes --version "v1.2.1"

# Or via mcp-bash doctor
mcp-bash doctor --fix

---

Full Changelog: v1.2.0...v1.2.1