Automic VaultAutomic Vault

brew

Install mcp-proxy with Homebrew, Nix

Bridge between Streamable HTTP and stdio MCP transports. Version 0.12.0 via Homebrew; verified 2026-06-21.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install mcp-proxy

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#mcp-proxy

nixpkgs package indexes · pkgs/by-name/mc/mcp-proxy/package.nix · source: api.github.com

overview

Package summary

Bridge between Streamable HTTP and stdio MCP transports

Commands and aliases

  • mcp-proxy
  • mcp-reverse-proxy

history

Project history and usage

mcp-proxy is a Python CLI bridge for switching between MCP transports. It connects stdio-only MCP clients to remote SSE or Streamable HTTP servers, and can also expose a local stdio server over an HTTP-facing MCP transport.

Project history

The public repository was created in December 2024, early in the wave of small utilities that filled gaps between rapidly changing MCP client and server transport support. Its README defines two core modes: stdio to SSE/Streamable HTTP and SSE to stdio.

As MCP moved beyond purely local stdio servers, mcp-proxy became a practical compatibility layer rather than a general-purpose network proxy. The README is careful to frame it as a transport switcher for MCP clients and servers, with command-line options for headers, OAuth client credentials, CORS, named servers, and environment passing.

Adoption history

The project is packaged on PyPI, can be installed with uv or pipx, and is also available through Homebrew and Nix according to the input package facts. That mix made it convenient for both Python tool users and package-manager users who wanted a stable `mcp-proxy` command.

GitHub metadata showed thousands of stars and hundreds of forks by July 2026, and the release feed showed continued 0.x releases into 2026. That adoption pattern matches its niche: a small command-line compatibility tool that becomes widely referenced while clients catch up with newer MCP transports.

How it is used

In stdio-to-remote mode, users place `mcp-proxy` in an MCP client configuration and pass the remote SSE endpoint or Streamable HTTP endpoint as an argument. The README documents optional authorization headers and an `API_ACCESS_TOKEN` environment variable for bearer-token scenarios.

In remote-to-stdio mode, users run `mcp-proxy` with a local MCP server command and a listening port, optionally defining named servers in JSON. This lets remote clients reach local stdio MCP servers at URL paths such as `/servers/<name>/`.

Why package nerds care

mcp-proxy matters to package users because it turns transport support into a package-manager-installable shim. Instead of waiting for every MCP client to support every transport, users can install one CLI and keep existing server packages unchanged.

It is also a good example of the MCP ecosystem's early packaging style: small, single-purpose CLIs distributed through language-native channels first, then wrapped by system package managers once they become common glue in user configurations.

Timeline

  • 2024: GitHub repository created for sparfenyuk/mcp-proxy.
  • 2025: README documents stdio, SSE, and Streamable HTTP transport bridging.
  • 2025: Named server configuration and JSON config support documented.
  • 2026: v0.12.0 release published, with active 0.x release cadence continuing.

Related projects

  • modelcontextprotocol/inspector includes its own MCP proxy component for the Inspector UI.
  • geelen/mcp-remote focuses on remote MCP servers with OAuth support for stdio-only clients.
  • MCP clients such as Claude Desktop are common consumers of mcp-proxy configurations.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for mcp-proxy. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 1 platform targets.
  • Installs with 5 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
mcp-proxycliglobal executable
mcp-reverse-proxycliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.12.0
manager updated2026-06-21
local dataok
upstreamnot checked
latest detectednot detected

https://github.com/sparfenyuk/mcp-proxy

install metadata

Package metadata

Package keybrew:mcp-proxy
Version0.12.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/mcp-proxy
Homepagehttps://github.com/sparfenyuk/mcp-proxy
Repositoryhttps://github.com/sparfenyuk/mcp-proxy
Upstream docshttps://github.com/sparfenyuk/mcp-proxy
LicenseMIT
Source archivehttps://files.pythonhosted.org/packages/3e/59/140a08a3282ee66b9c4726db4fb168844110f773cd1248bf051409bef04a/mcp_proxy-0.12.0.tar.gz
Last updated2026-06-21T10:47:08Z
Pulseupdated
Dependenciescertifi, cryptography, pydantic, python@3.14, rpds-py
Bottleavailable (on all)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namemcp-proxy
Version Scheme0
Revision3
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

mcp-proxy

nix profile install nixpkgs#mcp-proxy
  • normalized package name match
  • Matched by: Mcp Proxy
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/mc/mcp-proxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • python@3.14Runtime dependency declared by Homebrew.
  • mcp-proxySame normalized package name appears in another local ecosystem. Shared terms: mcp, mcp-proxy, proxy, sse, stdio.

Same workflow

  • brookShares av.db curated category or tags: cli, networking, proxy.
  • cntlmShares av.db curated category or tags: cli, networking, proxy.
  • connectShares av.db curated category or tags: cli, networking, proxy.
  • ctrldShares av.db curated category or tags: cli, networking, proxy.
  • danteShares av.db curated category or tags: cli, networking, proxy.
  • dsocksShares av.db curated category or tags: cli, networking, proxy.
  • mcp-proxySame normalized package name in another local ecosystem.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment