Installation

mcpgw is one static binary with no runtime dependencies. Pick whichever of these you already trust.

Installer script

curl -fsSL https://github.com/kennywillbe/mcpgw/releases/latest/download/mcpgw-installer.sh | sh

Detects your platform, downloads that archive and puts the binary in ~/.local/bin. Two knobs:

MCPGW_INSTALL_DIR=/usr/local/bin sh -c "$(curl -fsSL .../mcpgw-installer.sh)"
MCPGW_VERSION=0.1.0              sh -c "$(curl -fsSL .../mcpgw-installer.sh)"

The script does not check signatures or hashes. If you want that, use the archive route below and verify against SHA256SUMS yourself.

Homebrew

brew install kennywillbe/tap/mcpgw

Cargo

cargo install mcpgw

Builds from source, so it works on any target Rust supports — including ones with no prebuilt archive.

From a release archive

Every release attaches one archive per platform plus a combined SHA256SUMS:

version=0.1.0
target=aarch64-apple-darwin
base=https://github.com/kennywillbe/mcpgw/releases/download/v${version}

curl -fsSLO "${base}/mcpgw-${version}-${target}.tar.gz"
curl -fsSLO "${base}/SHA256SUMS"
grep " mcpgw-${version}-${target}.tar.gz\$" SHA256SUMS | shasum -a 256 -c -

tar -xzf "mcpgw-${version}-${target}.tar.gz"
install "mcpgw-${version}-${target}/mcpgw" /usr/local/bin/

Prebuilt targets: aarch64-apple-darwin, x86_64-apple-darwin, x86_64-unknown-linux-gnu, x86_64-pc-windows-msvc.

Updating

mcpgw self-update

Downloads the latest release archive for your platform, checks it against the release's SHA256SUMS, and replaces the running binary with it. It refuses to touch an install that belongs to a package manager: under ~/.cargo/bin it tells you to run cargo install mcpgw, under a Homebrew prefix brew upgrade mcpgw.

mcpgw self-update --check changes nothing and only reports, exiting 0 when you already have the latest release and 10 when you don't — a pair a script can branch on.

Once a day, after a command has finished, mcpgw asks GitHub whether a newer release exists and prints one line to stderr if there is:

mcpgw 0.2.0 is available (you have 0.1.0) — run `mcpgw self-update`

It never writes to stdout, so --json output stays parseable, and it stays quiet when the network doesn't answer. MCPGW_NO_UPDATE_CHECK=1 turns it off entirely.

Check it

mcpgw --version
mcpgw doctor

On a fresh machine doctor will tell you there's no config yet and list which clients it found. That's the expected first-run state — go to the Quickstart.