explaingit

punkpeye/mcp-proxy

Analysis updated 2026-07-07 · repo last pushed 2026-06-27

267TypeScriptAudience · developerComplexity · 3/5ActiveSetup · easy

TLDR

MCP Proxy exposes local AI tool servers over the web so browser apps and remote clients can reach them. It bridges local command-line tools to HTTP and SSE endpoints.

Mindmap

mindmap
  root((repo))
    What it does
      Exposes local tools over web
      Forwards HTTP requests
      Supports SSE transport
    Tech stack
      TypeScript
      Node.js
      CLI and library
    Use cases
      Web app uses local tool
      Share local server remotely
      Test webhooks locally
    Features
      API key auth
      CORS config
      Stateless mode
      Public tunnel
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let a browser-based chatbot use a local file-reading MCP tool.

USE CASE 2

Share a local AI tool server with a remote colleague via a public tunnel.

USE CASE 3

Test webhooks against a local MCP server without deploying anything.

USE CASE 4

Run MCP tools on serverless platforms using stateless mode.

What is it built with?

TypeScriptNode.js

How does it compare?

punkpeye/mcp-proxyseochecks-ai/sloplesstexsellix/polymarket-trading-bot
Stars267255244
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-27
MaintenanceActive
Setup difficultyeasyeasymoderate
Complexity3/52/54/5
Audiencedeveloperwriterdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Run as a one-line command pointing at any compatible MCP server, Python-based servers may need output buffering fixes.

In plain English

MCP Proxy lets you take a local AI tool server that only talks through command-line-style input and output, and expose it over the web so that browser-based apps and other network clients can connect to it. This matters because many tools built for the Model Context Protocol (a standard for connecting AI assistants to external data and services) are designed to run on your local machine. Without something like this proxy, those tools can't easily be reached from a web app or a remote server. The way it works is straightforward: you launch your local tool server through the proxy, and the proxy starts listening on a web port. When a client sends an HTTP request, the proxy forwards it to your local server and passes the response back. It supports two communication patterns, streaming HTTP and server-sent events (SSE), so clients can choose either. You can run it as a one-line command pointing at any compatible server, or use it as a library inside a larger Node.js project. This is useful for developers building AI-powered applications who want to use existing MCP tools from a web interface rather than only from a terminal. For example, if you have a filesystem tool that reads local files and you want a web-based chatbot to use it, the proxy bridges that gap. It also includes a public tunnel feature, so you can share a local server with a remote colleague or test webhooks without deploying anything. A few practical touches stand out. You can add API key authentication to protect your endpoints, configure CORS so browsers on different domains can access the server, and run in a "stateless" mode that spins up a fresh server instance per request, handy for serverless platforms where you don't control persistent connections. There's also a debug mode for troubleshooting and specific guidance for Python-based servers, which can silently fail if their output buffering delays protocol messages. The project is built in TypeScript and can be used either as a quick command-line tool or as a programmable library for more custom integrations.

Copy-paste prompts

Prompt 1
Help me install and run mcp-proxy from the command line to expose my local MCP server at localhost:3000. Show me the exact command and any flags I need for API key authentication.
Prompt 2
I want to use mcp-proxy as a library inside my existing Node.js project to bridge a local MCP filesystem tool to an SSE endpoint. Write the integration code and explain how to configure CORS for my frontend domain.
Prompt 3
I am running a Python-based MCP server and the proxy seems to hang with no output. Help me troubleshoot Python output buffering issues and apply the recommended fix so protocol messages are not delayed.
Prompt 4
Set up mcp-proxy in stateless mode so it spins up a fresh server instance per request, suitable for a serverless platform like AWS Lambda. Walk me through the config and any gotchas.

Frequently asked questions

What is mcp-proxy?

MCP Proxy exposes local AI tool servers over the web so browser apps and remote clients can reach them. It bridges local command-line tools to HTTP and SSE endpoints.

What language is mcp-proxy written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

Is mcp-proxy actively maintained?

Active — commit in last 30 days (last push 2026-06-27).

How hard is mcp-proxy to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mcp-proxy for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.