Installing `mcpd`¶

via Homebrew¶

Add the Mozilla.ai tap:

brew tap mozilla-ai/tap

Then install mcpd:

brew install mcpd

Or install directly from the cask:

brew install --cask mozilla-ai/tap/mcpd

via GitHub releases¶

Official releases can be found on the mcpd GitHub releases page.

The following is an example of manually downloading and installing mcpd using curl and jq by running install_mcpd:

function install_mcpd() {
    command -v curl >/dev/null || { echo "curl not found"; return 1; }
    command -v jq >/dev/null || { echo "jq not found"; return 1; }

    latest_version=$(curl -s https://api.github.com/repos/mozilla-ai/mcpd/releases/latest | jq -r .tag_name)
    os=$(uname)
    arch=$(uname -m)

    zip_name="mcpd_${os}_${arch}.tar.gz"
    url="https://github.com/mozilla-ai/mcpd/releases/download/${latest_version}/${zip_name}"

    echo "Downloading: $url"
    curl -sSL "$url" -o "$zip_name" || { echo "Download failed"; return 1; }

    echo "Extracting: $zip_name"
    tar -xzf "$zip_name" mcpd || { echo "Extraction failed"; return 1; }

    echo "Installing to /usr/local/bin"
    sudo mv mcpd /usr/local/bin/mcpd && sudo chmod +x /usr/local/bin/mcpd || { echo "Install failed"; return 1; }

    rm -f "$zip_name"
    echo "mcpd installed successfully"
}

macOS Gatekeeper quarantine

If you're on macOS, remove the quarantine flag before running mcpd:

xattr -d com.apple.quarantine mcpd

via local Go binary build¶

# Clone the Git repo
git clone git@github.com:mozilla-ai/mcpd.git
cd mcpd
# Checkout a specific tag (or build latest main)
git fetch --tags
git checkout v0.0.5
# Use Makefile commands to build and install mcpd
make build
sudo make install # Installs mcpd 'globally' to /usr/local/bin

Run with Docker¶

mcpd is available as the Docker image mzdotai/mcpd.

Dockerfile environment variables

The Dockerfile defines sensible defaults for configuration via environment variables. These can be overridden at runtime using docker run -e KEY=VALUE.

Default environment variables¶

Name	Default Value
`MCPD_API_PORT`	`8090`
`MCPD_LOG_LEVEL`	`info`
`MCPD_LOG_PATH`	`/var/log/mcpd/mcpd.log`
`MCPD_CONFIG_FILE`	`/etc/mcpd/.mcpd.toml`
`MCPD_RUNTIME_FILE`	`/home/mcpd/.config/mcpd/secrets.prd.toml`

To run mcpd with Docker, map the required port and bind mount your .mcpd.toml configuration file and runtime secrets file:

docker run  -p 8090:8090 \
            -v $PWD/.mcpd.toml:/etc/mcpd/.mcpd.toml \
            -v $HOME/.config/mcpd/secrets.dev.toml:/home/mcpd/.config/mcpd/secrets.prd.toml \
            -e MCPD_LOG_LEVEL=debug \
            mzdotai/mcpd:v0.0.5

Installing mcpd¶