MCP transport bridge that converts between stdio, SSE, and Streamable HTTP so local MCP clients can reach remote servers, or remote clients can reach local stdio servers.
mcp-proxy can expose local stdio MCP servers as network services; keep the host bound to `127.0.0.1` unless remote access is intentional., Passing `--host=0.0.0.0`, permissive CORS, or named-server routes can make tools reachable by other systems on the network., Proxy configuration can include bearer tokens, OAuth client secrets, headers, server commands, environment variables, and working directories., The proxy can spawn arbitrary configured MCP server commands; only use trusted command strings and config files., Remote SSE or Streamable HTTP servers should be authenticated and trusted before forwarding client requests or tool outputs.
Privacy notes
MCP requests, responses, tool outputs, progress events, headers, OAuth tokens, API access tokens, and session identifiers may pass through the proxy process., Named server config files can contain command arguments, environment variables, and credentials for downstream MCP servers., Exposed network endpoints can reveal tool names, server status, and results to clients that can reach the proxy., Logs and troubleshooting output may include endpoint URLs, command names, headers, connection errors, or server names., Store config files outside shared repositories when they include tokens or private server details.
Author
Sergey Parfenyuk
Submitted by
oktofeesh1
Claim status
unclaimed
Last verified
2026-06-06
Decision playbook
Review trust signals before you adopt
Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.
Compare context
Selected
0
Current score
63
Baseline
—
Delta
No baseline selected
No major trust-signal divergence detected in the current selection.
Source and provenance checks
Needs review
Confirm ownership and provenance before trusting install instructions.
Source link availableRequired
Open the canonical repository and verify ownership.
Done
Source provenance statusRequired
Marked as source-backed.
Done
Metadata reviewed
No reviewed flag detected in metadata.
Pending
Safety and privacy checks
Complete
Validate risk disclosures before installation or API wiring.
Safety notes presentRequired
Review the listed safety guidance before running commands.
Done
Privacy notes presentRequired
Review data handling notes before connecting accounts or secrets.
Done
Trust level risk gateRequired
Trust level does not block evaluation.
Done
Package and install checks
Needs review
Check package metadata and artifact integrity signals.
Install payload available
Install or copy payload is available for review.
Done
Package verification flag
No package verification flag provided.
Pending
Checksum metadata
No checksum provided for downloaded artifact.
Pending
Compare-driven decision checks
Needs review
Use compare context to validate trade-offs before adoption.
Compare tray has multiple entries
Add at least one more entry to compare trust differences.
5 safety and 5 privacy notes across 3 risk areas. Review closely: credentials & tokens, network access.
3 areas
SafetyNetwork accessmcp-proxy can expose local stdio MCP servers as network services; keep the host bound to `127.0.0.1` unless remote access is intentional.
SafetyNetwork accessPassing `--host=0.0.0.0`, permissive CORS, or named-server routes can make tools reachable by other systems on the network.
SafetyCredentials & tokensProxy configuration can include bearer tokens, OAuth client secrets, headers, server commands, environment variables, and working directories.
SafetyLocal filesThe proxy can spawn arbitrary configured MCP server commands; only use trusted command strings and config files.
SafetyNetwork accessRemote SSE or Streamable HTTP servers should be authenticated and trusted before forwarding client requests or tool outputs.
PrivacyCredentials & tokensMCP requests, responses, tool outputs, progress events, headers, OAuth tokens, API access tokens, and session identifiers may pass through the proxy process.
PrivacyCredentials & tokensNamed server config files can contain command arguments, environment variables, and credentials for downstream MCP servers.
PrivacyNetwork accessExposed network endpoints can reveal tool names, server status, and results to clients that can reach the proxy.
PrivacyNetwork accessLogs and troubleshooting output may include endpoint URLs, command names, headers, connection errors, or server names.
PrivacyCredentials & tokensStore config files outside shared repositories when they include tokens or private server details.
Disclosure: MIT-licensed Python MCP transport bridge. It does not provide domain-specific tools itself; it proxies other MCP servers across transports.
Safety notes
mcp-proxy can expose local stdio MCP servers as network services; keep the host bound to `127.0.0.1` unless remote access is intentional.
Passing `--host=0.0.0.0`, permissive CORS, or named-server routes can make tools reachable by other systems on the network.
Proxy configuration can include bearer tokens, OAuth client secrets, headers, server commands, environment variables, and working directories.
The proxy can spawn arbitrary configured MCP server commands; only use trusted command strings and config files.
Remote SSE or Streamable HTTP servers should be authenticated and trusted before forwarding client requests or tool outputs.
Privacy notes
MCP requests, responses, tool outputs, progress events, headers, OAuth tokens, API access tokens, and session identifiers may pass through the proxy process.
Named server config files can contain command arguments, environment variables, and credentials for downstream MCP servers.
Exposed network endpoints can reveal tool names, server status, and results to clients that can reach the proxy.
Logs and troubleshooting output may include endpoint URLs, command names, headers, connection errors, or server names.
Store config files outside shared repositories when they include tokens or private server details.
Prerequisites
Python 3.10 or newer.
uv, pipx, or Docker for installation.
A known MCP endpoint or local stdio MCP server to bridge.
Review of required headers, OAuth client credentials, CORS origins, host, port, and named-server configuration.
A plan for network binding if exposing local stdio servers through SSE or Streamable HTTP.
Schema details
Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
10 minutes
Difficulty
intermediate
Tool listing metadata
Disclosure
MIT-licensed Python MCP transport bridge. It does not provide domain-specific tools itself; it proxies other MCP servers across transports.
mcp-proxy bridges MCP transports. It can let a stdio-only client such as Claude
Desktop connect to a remote SSE or Streamable HTTP server, or expose a local
stdio MCP server through SSE or Streamable HTTP for clients that need a network
endpoint.
Use it when transport mismatch is the blocker and the downstream MCP server is
already trusted. It is especially useful for remote servers, containerized
setups, named local servers, and client/server combinations that do not share the
same MCP transport.
These sources were reviewed on 2026-06-06. Prefer the live repository,
README, PyPI metadata, license, package metadata, example config, CLI entrypoint,
MCP server implementation, and proxy server implementation for current setup and
behavior details.
Features
Bridge local stdio clients to remote SSE MCP servers.
Bridge local stdio clients to remote Streamable HTTP MCP servers.
Expose local stdio MCP servers through SSE or Streamable HTTP.
Pass authorization headers or an API_ACCESS_TOKEN environment variable to
remote servers.
Support OAuth2 client credentials through client ID, client secret, and token
URL options.
Configure host, port, CORS origins, exposed headers, working directory, and
environment variables for spawned servers.
Publish multiple named stdio MCP servers under separate URL paths.
Load named servers from a JSON MCP-style configuration file.
Run as a PyPI-installed CLI or container image.
Installation
Install the PyPI package with uv or pipx:
uv tool install mcp-proxy
pipx install mcp-proxy
For a stdio client connecting to a remote SSE endpoint:
Connect Claude Desktop to a remote SSE MCP server.
Use a Streamable HTTP MCP server from a client that only supports stdio.
Expose a local stdio MCP server to an MCP client that expects an HTTP
endpoint.
Group several local stdio MCP servers behind named URL paths.
Wrap containerized MCP servers so tools can move between local desktop and
web-client workflows.
Safety and Privacy
mcp-proxy is only as safe as the endpoints, commands, credentials, and network
bindings you give it. Keep local bridges bound to loopback by default, avoid
wildcard CORS unless required, and do not expose unauthenticated tool endpoints
on shared networks.
Treat proxy configs as sensitive. They can contain bearer tokens, OAuth secrets,
server commands, environment variables, endpoint URLs, and downstream MCP server
details that should not be committed to shared repositories.
Show that mcp-proxy Transport Bridge is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.
[](https://heyclau.de/entry/mcp/mcp-proxy-transport-bridge)
How it compares
mcp-proxy Transport Bridge side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.
1 trust signal differ across this comparison (Submitter).
MCP transport bridge that converts between stdio, SSE, and Streamable HTTP so local MCP clients can reach remote servers, or remote clients can reach local stdio servers.
Hosted streamable-HTTP MCP server that exposes inference.sh platform tools for running apps, managing tasks, proxying external MCP connectors, and calling hundreds of hosted AI models from Claude Code, Cursor, and other MCP clients.
Built-in Streamable HTTP MCP server for Nuclear Music Player that lets Claude inspect available music-player domains, discover method signatures, describe data types, and control playback, queue, favorites, playlists, dashboard, and provider workflows.
Hosted streamable-HTTP MCP server registered as ai.com.mcp/skills-search that exposes Agent Skills Search API tools for discovering skills from the skills.sh registry using the open Agent Skills format.
✓mcp-proxy can expose local stdio MCP servers as network services; keep the host bound to `127.0.0.1` unless remote access is intentional.
Passing `--host=0.0.0.0`, permissive CORS, or named-server routes can make tools reachable by other systems on the network.
Proxy configuration can include bearer tokens, OAuth client secrets, headers, server commands, environment variables, and working directories.
The proxy can spawn arbitrary configured MCP server commands; only use trusted command strings and config files.
Remote SSE or Streamable HTTP servers should be authenticated and trusted before forwarding client requests or tool outputs.
✓The hosted MCP server can execute inference.sh apps, platform tasks, and proxied connector tools that may create, update, or delete data in connected services such as GitHub, Linear, Slack, Notion, or databases.
Bearer API keys grant account-scoped access to platform capabilities; rotate compromised keys immediately and avoid committing tokens to repositories or shared MCP config files.
MCP proxy features can discover and call tools on remote MCP servers through inference.sh, which expands the runtime trust boundary beyond the primary client configuration.
Tool calls may trigger paid inference, connector actions, storage writes, or outbound network requests according to the selected app or connector.
Use least-privilege connector authorization and review each proxied server before enabling it in production agent workflows.
✓Nuclear MCP Server runs inside the local Nuclear desktop app and exposes a Streamable HTTP server on the localhost interface.
The `call` tool can execute Nuclear API methods after discovery through `list_methods`, `method_details`, and `describe_type`.
Available domains include Queue, Playback, Metadata, Favorites, Playlists, Dashboard, and Providers, so agents can change what is playing and modify local music-player state.
Nuclear's plugin and provider system can retrieve streaming sources, metadata, playlists, and dashboard content from third-party services; use providers only where automated access is allowed.
Keep the server bound to localhost, avoid exposing the MCP endpoint on a network interface, and require confirmation before letting an agent change playlists, favorites, queues, or provider settings.
✓Search results expose skill metadata and install instructions; installing a skill can give an agent executable scripts, shell commands, and third-party repository access.
Treat discovered skills like unreviewed dependencies—inspect `SKILL.md`, scripts, and publisher sources before `npx skills add` or equivalent installers run.
Self-hosted HAPI deployments inherit API rate limits and outbound network access to `https://skills.sh/api`; scope firewall and logging policies accordingly.
Hosted remotes process search queries on vendor infrastructure; avoid sending confidential project names or customer identifiers in search strings when policy requires on-prem discovery.
Privacy notes
✓MCP requests, responses, tool outputs, progress events, headers, OAuth tokens, API access tokens, and session identifiers may pass through the proxy process.
Named server config files can contain command arguments, environment variables, and credentials for downstream MCP servers.
Exposed network endpoints can reveal tool names, server status, and results to clients that can reach the proxy.
Logs and troubleshooting output may include endpoint URLs, command names, headers, connection errors, or server names.
Store config files outside shared repositories when they include tokens or private server details.
✓Prompts, files, tool arguments, task metadata, connector payloads, and model outputs are processed by inference.sh and may transit connected third-party MCP services.
OAuth-backed connectors can expose account, workspace, issue, message, or repository content to the agent through proxied tool results.
API keys, connector tokens, and task logs should be treated as sensitive credentials and kept out of version control and public issue threads.
Hosted execution may retain usage, billing, and operational telemetry according to inference.sh policies; review the platform privacy documentation before processing regulated data.
✓Tool calls and transcripts can include listening history, search terms, artists, albums, track titles, playlist names, favorites, provider choices, dashboard content, and local player settings.
The MCP endpoint is local, but connected MCP clients, model providers, logs, screenshots, and shared chat transcripts can still retain music-library and listening-behavior data.
Streaming and metadata providers may receive searches, track identifiers, IP addresses, user-agent metadata, or plugin-specific account context according to their own policies.
The MCP server URL and port are local connection details; do not publish screenshots or logs that include private player state or provider credentials.
✓Search queries, skill names, registry metadata, and tool responses enter MCP client context and may be logged by the hosted remote operator.
skills.sh registry responses can include publisher URLs, install counts, and repository identifiers that reveal technology choices to shared clients.
Installing skills from search results may download repository archives or scripts that process local files; review each skill's privacy posture before use.
Self-hosted HAPI CLI mode keeps search traffic on your infrastructure but still contacts the public skills.sh API unless you mirror the backend.
Prerequisites
Python 3.10 or newer.
uv, pipx, or Docker for installation.
A known MCP endpoint or local stdio MCP server to bridge.
Review of required headers, OAuth client credentials, CORS origins, host, port, and named-server configuration.
An inference.sh account and API key from `belt login` or the platform dashboard.
An MCP client that supports streamable HTTP transport, such as Claude Code, Cursor, Cline, or Windsurf.
Review of which inference.sh apps, connectors, and proxy tools the agent may call before enabling write-capable workflows.
A billing and quota plan if the workflow will run image, video, LLM, search, or connector-backed tasks at scale.
Nuclear Music Player installed from the project's releases or platform packages.
MCP server enabled in Nuclear under Settings > Integrations.
MCP client support for Streamable HTTP or remote URL based server configuration.
Review of the actual local URL shown by Nuclear because the server starts on ports 8800 through 8809.
An MCP client that supports streamable HTTP transport, such as Claude Code, Cursor, Cline, or Windsurf.
Review of which discovered skills the agent may install or execute before enabling autonomous workflows.
Optional Docker or HAPI CLI setup if you need a self-hosted skills-search server instead of the hosted remote.
Install
uv tool install mcp-proxy
Run `belt login` to create an inference.sh API key, then add the streamable HTTP MCP endpoint `https://api.inference.sh/mcp` with `Authorization: Bearer inf_<your_api_key>` in your MCP client settings.
claude mcp add nuclear --transport http <copy-url-from-nuclear-settings>
Add the streamable HTTP MCP endpoint `https://skills-sh.run.mcp.com.ai/mcp` to your MCP client, then call `searchSkills` to query the skills.sh registry.