LibreAI / Dev Tools / mcp-proxy
// devtools · sparfenyuk/mcp-proxy

mcp-proxy

A bridge between Streamable HTTP / SSE and stdio MCP transports — connect any client to any server

★ 2.8k stars⑂ 268 forksMITupdated 2026-07
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

mcp-proxy is an open-source dev tools project by sparfenyuk (sparfenyuk/mcp-proxy on GitHub). It has 2,776 GitHub stars and 268 forks, is released under the MIT license, and was last updated on GitHub on 20 July 2026.

GitHub stars
2,776
Forks
268
License
MIT
Last updated on GitHub
20 July 2026
Category
Dev Tools
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide the direction: a stdio client reaching a remote HTTP server, or a local stdio server being exposed over HTTP.

  2. Get mcp-proxy

    Install it from PyPI with uv or pipx, or pull the container image.

  3. Configure

    Add it to your MCP client config with the server URL or command, plus any headers, OAuth settings or named-server definitions.

  4. Run your first call

    Restart the client and confirm the proxied server's tools appear and a tool call succeeds.

// features

Why people love it

stdio → SSE/Streamable HTTP

Connects stdio clients to a remote server URL, with --transport to force sse or streamablehttp.

SSE/Streamable HTTP → stdio

Spawns a local stdio server (command after --) and serves it on a host/port you choose.

Named servers

--named-server or a JSON config file hosts several stdio servers under /servers/<name>/ paths, with a /status endpoint.

Auth passthrough

Supports custom headers, an API_ACCESS_TOKEN environment variable, and OAuth2 client-id/secret/token-url options.

Env and cwd control

--env, --cwd and --pass-environment control the environment the spawned server runs with.

Container image

Published to GHCR and Docker Hub as multi-platform (amd64/arm64) images, extensible with your own Dockerfile.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone mcp-proxy if you want the source; most users install from PyPI in step 2.

    git clone https://github.com/sparfenyuk/mcp-proxy.git
    cd mcp-proxy
  2. Install from PyPI

    Install the published package with uv (recommended) or pipx.

    uv tool install mcp-proxy
  3. Proxy a local server over HTTP

    Expose a local stdio MCP server on port 8080, as the README examples show.

    mcp-proxy --port=8080 uvx mcp-server-fetch
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains mcp-proxy?

sparfenyuk maintains it, with the package published on PyPI as mcp-proxy.

Is it free?

Yes, it is MIT-licensed.

Does it need a paid API key?

No — it is transport plumbing. The servers you proxy may have their own keys, which you pass through via headers or env.

How does it compare to MetaMCP or MCPHub?

Those are gateways that aggregate many servers with dashboards and auth. mcp-proxy is a focused, single-purpose transport bridge you run as a command.

How do I get started?

uv tool install mcp-proxy, then add it to your client config pointing at a server URL, or run mcp-proxy --port=8080 <stdio command>.

// keep exploring

Similar tools

Dev Tools

dbx

A 25MB database client for 100+ databases — with a built-in AI assistant, MCP server and CLI

★ 25.2k starsApache-2.0
View guide →
Dev Tools

mcp2cli

Turn any MCP server, OpenAPI spec or GraphQL endpoint into a CLI — at runtime, with zero codegen

★ 2.4k starsMIT
View guide →
Dev Tools

jcodemunch-mcp

Symbol-level code retrieval MCP server (tree-sitter AST) built to slash agent token costs on exploration

★ 2.7k starsNOASSERTION
View guide →
Dev Tools

apple-docs-mcp

MCP server that puts Apple developer docs inside your AI coding assistant.

★ 1.4k starsMIT
View guide →
Dev Tools

ripwire

The ripgrep of AI context — a zero-dependency C++23 CLI + MCP server that maps your repo for coding agents

★ 2.4k starsApache-2.0
View guide →
Dev Tools

ddgs

A Python metasearch library aggregating many web search services — plus CLI, API and MCP server

★ 3.0k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if mcp-proxy is not the right fit.

Get mcp-proxy

Free and open — grab the source, star the repo, and start creating.