# Install mcp-remote with Homebrew Remote proxy for Model Context Protocol with OAuth support. Version 0.1.38 via Homebrew; verified 2026-04-24. ## Install ```sh sudo av install brew:mcp-remote ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install mcp-remote ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:mcp-remote - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.1.38 - **Source summary:** Remote proxy for Model Context Protocol with OAuth support - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-04-24T23:43:42Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - mcp-remote (cli) - mcp-remote-client (cli) - mcp-remote (alias) - mcp-remote-client (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.1.38 - Package-manager updated: 2026-04-24 - Local data: ok - Upstream repository: https://github.com/geelen/mcp-remote - info: No cached GitHub release or tag data was available. ## Project history and usage mcp-remote is a TypeScript CLI that lets stdio-only MCP clients connect to remote MCP servers, including servers that require OAuth. Its README explicitly frames it as a temporary bridge until popular clients support remote authorized MCP servers directly. ### Project history The repository was created in March 2025, after the MCP authorization specification introduced a secure model for remote MCP servers. The README calls the project a working proof of concept and explains the gap it fills: many clients could launch local stdio servers, while remote HTTP/SSE servers and OAuth flows were not yet uniformly supported. The project evolved around practical client configuration examples for Claude Desktop, Cursor, Windsurf, and similar tools. Later README sections document transport strategies, custom headers, static OAuth metadata, proxy environment support, debug logs, and client-mode troubleshooting. ### Adoption history mcp-remote gained adoption as a one-line `npx` adapter in client configuration files. GitHub metadata showed more than a thousand stars and hundreds of forks by July 2026, and tags indicated continued 0.1.x package iteration. Its usage is closely tied to the adoption curve for remote MCP servers. As hosted MCP services appeared before every client had native remote OAuth support, mcp-remote gave users a package-level compatibility layer that could be installed or executed on demand. ### How it is used Typical use places `npx mcp-remote https://remote.mcp.server/sse` in the `command` and `args` section of an MCP client configuration. The README documents flags for headers, resource isolation, HTTP allowances, transport order, OAuth callback port, ignored tools, and proxy environment variables. The tool stores credential information in `~/.mcp-auth` unless `MCP_REMOTE_CONFIG_DIR` points elsewhere. The README also documents a `mcp-remote-client` mode for running an authorization flow from the command line when troubleshooting stale credentials or token refresh problems. ### Why package nerds care mcp-remote is a textbook bridge package: it exists because the protocol moved faster than client feature support. Package managers matter here because users can patch a capability gap with one command in an MCP client config instead of replacing the host application. The credential cache and OAuth behavior also make it more than a thin transport pipe. For package maintainers and users, it codifies a reusable auth-and-transport shim around remote MCP services while the ecosystem converges on native implementations. ### Timeline - 2025: GitHub repository created for geelen/mcp-remote. - 2025: README documents MCP authorization support and stdio-to-remote bridging. - 2025: Client configuration examples cover Claude Desktop, Cursor, and Windsurf. - 2026: 0.1.x tags and repository activity continue as remote MCP adoption grows. ### Related projects - sparfenyuk/mcp-proxy provides a broader MCP transport bridge without the same OAuth-centered positioning. - modelcontextprotocol/inspector can test MCP servers and includes transport/debugging tooling. - The MCP authorization specification is the upstream protocol feature that motivated the project. ### Sources - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Credential files - Unix: ~/.mcp-auth ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** mcp-remote - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [airtable-mcp-server](https://www.automicvault.com/pkg/brew/airtable-mcp-server/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [chrome-devtools-mcp](https://www.automicvault.com/pkg/brew/chrome-devtools-mcp/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-get](https://www.automicvault.com/pkg/brew/mcp-get/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-inspector](https://www.automicvault.com/pkg/brew/mcp-inspector/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-publisher](https://www.automicvault.com/pkg/brew/mcp-publisher/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcphost](https://www.automicvault.com/pkg/brew/mcphost/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcpm](https://www.automicvault.com/pkg/brew/mcpm/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcptools](https://www.automicvault.com/pkg/brew/mcptools/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-remote](https://www.automicvault.com/pkg/npm/mcp-remote/) - Same normalized package name appears in another local ecosystem. Shared terms: client, context, mcp, mcp-remote, mcp-remote-client. - [mcp-remote](https://www.automicvault.com/pkg/npm/mcp-remote/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/mcp-remote.yml](https://github.com/automic-vault/db/blob/main/combined/mcp-remote.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph