mxm/mcp-bridge
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
2 releases 11 tags
  • v3.0.0 dafc722e3f

    v3.0.0
    Some checks failed
    release / goreleaser (push) Failing after 30s
    Details
    Stable

    mxm released this 2026-09-18 11:08:56 +02:00 | 1 commits to main since this release

    [3.0.0] - 2026-09-18

    Breaking changes

    • Removed /mcp setup and its template commands, including /mcp setup templates and /mcp setup add. Server installation is now generic: /mcp install [options] <name> <commandOrUrl> [args...]. Supply an executable or URL rather than a preset name.
    • The install command defaults to --scope local (<cwd>/.zot/mcp.json). Use --scope project for <cwd>/.mcp.json or --scope user for $ZOT_HOME/mcp.json; scopes use zot's existing locations, not Claude's private configuration store.

    Added

    • Core claude mcp add-style options: -t/--transport (stdio, http, sse), repeatable -e/--env for stdio, repeatable -H/--header for HTTP/SSE, and -s/--scope. http maps to Streamable HTTP; --global and --project remain scope aliases.
    • Quoted values, backslash escapes, empty arguments, and -- forwarding for subprocess arguments. Environment references are saved literally and resolved when configuration loads; installation performs no shell expansion or execution.
    • Atomic, private configuration writes (mode 0600 on Unix), preserving other server entries and unknown JSON fields, including top-level fields. Duplicate names in the destination file are rejected rather than overwritten.
    • Configuration-only installation: no downloads, subprocess launches, or network requests during /mcp install. Run /reload-ext afterward to load the configuration and discover tools.

    Command reference

    • Bare /mcp shows help; /mcp status shows last-known server states, not a live health check.
    • OAuth installation flags (--client-id, --client-secret, --callback-port) are not supported. Use /mcp auth <name> after reload for browser authorization, or configure advanced OAuth settings in mcp.json.

    Migration

    Replace:

    /mcp setup add grep

    with:

    /mcp install --scope user -t http grep https://mcp.grep.app/
/reload-ext

    The explicit user scope retains the old setup command's global destination. For other former templates, provide the server command or URL explicitly; use -- before executables with flags.

    Already configured servers need no reinstall. Existing configuration files and OAuth credentials are unchanged by this upgrade. Do not run install again for entries already present in the target file.

    Downloads

    Prebuilt binaries: Linux amd64, Linux arm64, and Apple Silicon macOS. Download the archive for your platform and checksums.txt, verify its SHA-256, then extract into a new directory and run zot ext install /path/to/extracted-directory. macOS binaries are unsigned and not notarized. Each archive includes the binary, executable manifest, README, changelog, and MIT license.

    Artifacts were built locally from tag v3.0.0 (commit dafc722e3f9e90c5d3895199b1ae8d8e558d30af) with GoReleaser v2.18.2 and Go 1.25.10 after the Forgejo runner failed with a guest-command transport error. Unit tests, race tests, vet, archive checksums/manifests, and a macOS binary handshake passed.

    Downloads