# 使用 Homebrew 安装 mcp-remote 查看 mcp-remote 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:mcp-remote ``` 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install mcp-remote ``` 证据: local Homebrew formula metadata ## 软件包事实 - **软件包键:** brew:mcp-remote - **软件包管理器:** Homebrew - **软件包管理器页面:** - **版本:** 0.1.38 - **来源摘要:** Remote proxy for Model Context Protocol with OAuth support - **主页:** - **仓库:** - **上游文档:** - **许可证:** MIT - **源码归档:** - **最后更新:** 2026-04-24T23:43:42Z - **已生成:** 2026-07-08T07:18:31+00:00 ## 可执行文件 - mcp-remote (cli) - mcp-remote-client (cli) - mcp-remote (别名) - mcp-remote-client (别名) ## 依赖 - node ## 安装行为 - post-install 钩子: 未定义 - Bottle: 可用 于 all ## 版本和新鲜度 - 页面生成时间: 2026-07-08 - 管理器版本: 0.1.38 - 管理器更新时间: 2026-04-24 - 本地数据: OK - 上游仓库: https://github.com/geelen/mcp-remote - 信息: No cached GitHub release or tag data was available. ## 项目历史与用法 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. ### 项目历史 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. ### 采用历史 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. ### 使用方式 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. ### 为什么软件包爱好者会关心 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. ### 时间线 - 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. ### 来源 - - - - - ## 安全说明 broad file, network, media, or database tool signal. - **Geiger 风险:** blue / 中 - 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:** 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 ## 相关链接 - [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://www.automicvault.com/zh-hans/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [node](https://www.automicvault.com/zh-hans/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [airtable-mcp-server](https://www.automicvault.com/zh-hans/pkg/brew/airtable-mcp-server/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [chrome-devtools-mcp](https://www.automicvault.com/zh-hans/pkg/brew/chrome-devtools-mcp/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-get](https://www.automicvault.com/zh-hans/pkg/brew/mcp-get/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-inspector](https://www.automicvault.com/zh-hans/pkg/brew/mcp-inspector/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-publisher](https://www.automicvault.com/zh-hans/pkg/brew/mcp-publisher/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcphost](https://www.automicvault.com/zh-hans/pkg/brew/mcphost/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcpm](https://www.automicvault.com/zh-hans/pkg/brew/mcpm/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcptools](https://www.automicvault.com/zh-hans/pkg/brew/mcptools/) - Shares av.db curated category or tags: cli, developer-tools, mcp. - [mcp-remote](https://www.automicvault.com/zh-hans/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/zh-hans/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) ## 来源 - 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