Skip to main content
Glama

MCP Proxy Server

mcp-proxy

GitHub-LizenzPyPI – Python-VersionPyPI - Downloads

Um

Der mcp-proxy ist ein Tool, mit dem Sie zwischen Servertransporten wechseln können. Es werden zwei Modi unterstützt:

  1. stdio zu SSE/StreamableHTTP
  2. SSE zu stdio

1. stdio zu SSE/StreamableHTTP

Führen Sie von stdio aus einen Proxyserver aus, der eine Verbindung zu einem Remote-SSE-Server herstellt.

Dieser Modus ermöglicht Clients wie Claude Desktop die Kommunikation mit einem Remote-Server über SSE, obwohl dies nicht nativ unterstützt wird.

1.1 Konfiguration

In diesem Modus muss die URL des SSE-Endpunkts des MCP-Servers als erstes Argument des Programms angegeben werden. Wenn der Server streambaren HTTP-Transport verwendet, muss dieser auf der mcp-proxy Seite durch die Angabe von --transport=streamablehttp erzwungen werden.

Argumente

NameErforderlichBeschreibungBeispiel
command_or_urlJaDer SSE-Endpunkt des MCP-Servers, mit dem eine Verbindung hergestellt werden sollhttp://example.io/sse
--headersNEINFür die MCP-Server-SSE-Verbindung zu verwendende HeaderAutorisierung „Inhaber my-secret-access-token“
--transportNEINLegt fest, welches Transportprotokoll bei der Verbindung mit einem MCP-Server verwendet werden soll. Möglich sind entweder „sse“ oder „streamablehttp“.streamablehttp

Umgebungsvariablen

NameErforderlichBeschreibungBeispiel
API_ACCESS_TOKENNEINKann anstelle von --headers Authorization 'Bearer <API_ACCESS_TOKEN>'IHR_TOKEN

1.2 Anwendungsbeispiel

mcp-proxy soll vom MCP-Client gestartet werden, daher muss die Konfiguration entsprechend erfolgen.

Für Claude Desktop kann der Konfigurationseintrag folgendermaßen aussehen:

{ "mcpServers": { "mcp-proxy": { "command": "mcp-proxy", "args": [ "http://example.io/sse" ], "env": { "API_ACCESS_TOKEN": "access-token" } } } }

2. SSE zu stdio

Führen Sie einen Proxyserver aus, der einen SSE-Server verfügbar macht, der eine Verbindung zu einem lokalen Stdio-Server herstellt.

Dies ermöglicht Remoteverbindungen zum lokalen stdio-Server. Der mcp-proxy öffnet einen Port, um auf SSE-Anfragen zu warten, und startet einen lokalen stdio-Server, der MCP-Anfragen verarbeitet.

2.1 Konfiguration

Für diesen Modus muss das Argument --sse-port gesetzt sein. Das Argument --sse-host kann gesetzt werden, um die Host-IP-Adresse anzugeben, auf der der SSE-Server lauscht. Zusätzliche Umgebungsvariablen können mit dem Argument --env an den lokalen stdio-Server übergeben werden. Die Kommandozeilenargumente für den lokalen stdio-Server müssen nach dem Trennzeichen -- übergeben werden.

Argumente

NameErforderlichBeschreibungBeispiel
command_or_urlJaDer Befehl zum Starten des MCP-Stdio-Serversuvx mcp-server-fetch
--portNein, zufällig verfügbarDer zu überwachende MCP-Server-Port8080
--hostNein, standardmäßig 127.0.0.1Die Host-IP-Adresse, auf der der MCP-Server lauscht0.0.0.0
--envNEINZusätzliche Umgebungsvariablen zur Übergabe an den MCP-Standardserver. Kann mehrfach verwendet werden.FOO BAR
--cwdNEINDas Arbeitsverzeichnis, das an den MCP-stdio-Serverprozess übergeben werden soll./tmp
--pass-environmentNEINÜbergeben Sie alle Umgebungsvariablen beim Starten des Servers--no-pass-environment
--allow-originNEINErlaubte Ursprünge für den SSE-Server. Kann mehrfach verwendet werden. Standardmäßig ist kein CORS zulässig.--allow-origin "*"
--statelessNEINAktivieren Sie den zustandslosen Modus für streambare HTTP-Transporte. Der Standardwert ist „False“.--no-stateless
--named-server NAME COMMAND_STRINGNEINDefiniert einen benannten stdio-Server.--named-server fetch 'uvx mcp-server-fetch'
--named-server-config FILE_PATHNEINPfad zu einer JSON-Datei, die benannte stdio-Server definiert.--named-server-config /Pfad/zu/Servern.json
--sse-port (veraltet)Nein, zufällig verfügbarDer SSE-Server-Port, auf dem gelauscht werden soll8080
--sse-host (veraltet)Nein, standardmäßig 127.0.0.1Die Host-IP-Adresse, auf der der SSE-Server lauscht0.0.0.0

2.2 Anwendungsbeispiele

So starten Sie den mcp-proxy Proxyserver, der auf Port 8080 lauscht und eine Verbindung zum lokalen MCP-Server herstellt:

# Start the MCP server behind the proxy mcp-proxy uvx mcp-server-fetch # Start the MCP server behind the proxy with a custom port # (deprecated) mcp-proxy --sse-port=8080 uvx mcp-server-fetch mcp-proxy --port=8080 uvx mcp-server-fetch # Start the MCP server behind the proxy with a custom host and port # (deprecated) mcp-proxy --sse-host=0.0.0.0 --sse-port=8080 uvx mcp-server-fetch mcp-proxy --host=0.0.0.0 --port=8080 uvx mcp-server-fetch # Start the MCP server behind the proxy with a custom user agent # Note that the `--` separator is used to separate the `mcp-proxy` arguments from the `mcp-server-fetch` arguments # (deprecated) mcp-proxy --sse-port=8080 -- uvx mcp-server-fetch --user-agent=YourUserAgent mcp-proxy --port=8080 -- uvx mcp-server-fetch --user-agent=YourUserAgent # Start multiple named MCP servers behind the proxy mcp-proxy --port=8080 --named-server fetch 'uvx mcp-server-fetch' --named-server fetch2 'uvx mcp-server-fetch' # Start multiple named MCP servers using a configuration file mcp-proxy --port=8080 --named-server-config ./servers.json

Benannte Server

  • NAME wird im URL-Pfad /servers/NAME/ verwendet.
  • COMMAND_STRING ist der Befehl zum Starten des Servers (z. B. „uvx mcp-server-fetch“).
    • Kann mehrfach verwendet werden.
    • Dieses Argument wird ignoriert, wenn --named-server-config verwendet wird.
  • FILE_PATH – Falls angegeben, ist dies die exklusive Quelle für benannte Server und --named-server CLI-Argumente werden ignoriert.

Wenn ein Standardserver angegeben ist (das Argument command_or_url ohne --named-server oder --named-server-config ), ist dieser über die Stammpfade zugänglich (z. B. http://127.0.0.1:8080/sse ).

Benannte Server (unabhängig davon, ob sie mit --named-server oder --named-server-config definiert sind) sind unter /servers/<server-name>/ erreichbar (z. B. http://127.0.0.1:8080/servers/fetch1/sse ). Der Endpunkt /status stellt den globalen Status bereit.

JSON-Konfigurationsdateiformat für --named-server-config :

Die JSON-Datei sollte dieser Struktur folgen:

{ "mcpServers": { "fetch": { "disabled": false, "timeout": 60, "command": "uvx", "args": [ "mcp-server-fetch" ], "transportType": "stdio" }, "github": { "timeout": 60, "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "transportType": "stdio" } } }
  • mcpServers : Ein Wörterbuch, in dem jeder Schlüssel der Servername ist (verwendet im URL-Pfad, z. B. /servers/fetch/ ) und der Wert ein Objekt ist, das den Server definiert.
  • command : (Erforderlich) Der für den stdio-Server auszuführende Befehl.
  • args : (Optional) Eine Liste mit Argumenten für den Befehl. Standardmäßig ist die Liste leer.
  • enabled : (Optional) Wenn false , wird diese Serverdefinition übersprungen. Der Standardwert ist true .
  • timeout und transportType : Diese Felder sind in Standard-MCP-Clientkonfigurationen vorhanden, werden aber derzeit von mcp-proxy beim Laden benannter Server ignoriert . Der Transporttyp ist implizit „stdio“.

Installation

Installation über Smithery

So installieren Sie MCP Proxy für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install mcp-proxy --client claude

Installation über PyPI

Die stabile Version des Pakets ist im PyPI-Repository verfügbar. Sie können es mit dem folgenden Befehl installieren:

# Option 1: With uv (recommended) uv tool install mcp-proxy # Option 2: With pipx (alternative) pipx install mcp-proxy

Nach der Installation können Sie den Server mit dem Befehl mcp-proxy ausführen. Die Konfigurationsoptionen für die einzelnen Modi finden Sie oben.

Installation über das Github-Repository (neueste Version)

Die neueste Version des Pakets kann mit dem folgenden Befehl aus dem Git-Repository installiert werden:

uv tool install git+https://github.com/sparfenyuk/mcp-proxy

[!NOTE] Wenn Sie den Server bereits installiert haben, können Sie ihn mit dem Befehl uv tool upgrade --reinstall aktualisieren.

[!NOTE] Wenn Sie den Server löschen möchten, verwenden Sie den Befehl uv tool uninstall mcp-proxy .

Installation als Container

Ab Version 0.3.2 ist es möglich, das entsprechende Container-Image zu ziehen und auszuführen:

docker run -t ghcr.io/sparfenyuk/mcp-proxy:v0.3.2-alpine --help

Fehlerbehebung

  • Problem : Claude Desktop kann den Server nicht starten: ENOENT-Code in den ProtokollenLösung : Versuchen Sie, den vollständigen Pfad zur Binärdatei zu verwenden. Öffnen Sie dazu ein Terminal und führen Sie den Befehl where mcp-proxy (macOS, Linux) oder where.exe mcp-proxy (Windows) aus. Verwenden Sie anschließend den Ausgabepfad als Wert für das Attribut „command“:
    "fetch": { "command": "/full/path/to/bin/mcp-proxy", "args": [ "http://localhost:8932/sse" ] }

Erweitern des Container-Images

Sie können das mcp-proxy Container-Image um zusätzliche ausführbare Dateien erweitern. Beispielsweise ist uv nicht standardmäßig enthalten, Sie können damit aber ein benutzerdefiniertes Image erstellen:

# file: mcp-proxy.Dockerfile FROM ghcr.io/sparfenyuk/mcp-proxy:latest # Install the 'uv' package RUN python3 -m ensurepip && pip install --no-cache-dir uv ENV PATH="/usr/local/bin:$PATH" \ UV_PYTHON_PREFERENCE=only-system ENTRYPOINT [ "mcp-proxy" ]

Docker Compose-Setup

Mit der benutzerdefinierten Docker-Datei können Sie einen Dienst in Ihrer Docker Compose-Datei definieren:

services: mcp-proxy-custom: build: context: . dockerfile: mcp-proxy.Dockerfile network_mode: host restart: unless-stopped ports: - 8096:8096 command: "--pass-environment --port=8096 --sse-host 0.0.0.0 uvx mcp-server-fetch"

[!NOTE] Vergessen Sie nicht, das Argument --pass-environment festzulegen, da Sie sonst die Fehlermeldung „Kein Interpreter in verwalteten Installationen oder im Suchpfad gefunden“ erhalten.

Befehlszeilenargumente

usage: mcp-proxy [-h] [-H KEY VALUE] [--transport {sse,streamablehttp}] [-e KEY VALUE] [--cwd CWD] [--pass-environment | --no-pass-environment] [--debug | --no-debug] [--named-server NAME COMMAND_STRING] [--named-server-config FILE_PATH] [--port PORT] [--host HOST] [--stateless | --no-stateless] [--sse-port SSE_PORT] [--sse-host SSE_HOST] [--allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]] [command_or_url] [args ...] Start the MCP proxy. It can run as an SSE client (connecting to a remote SSE server and exposing stdio). Or, it can run as an SSE server (connecting to local stdio command(s) and exposing them over SSE). When running as an SSE server, it can proxy a single default stdio command or multiple named stdio commands (defined via CLI or a config file). positional arguments: command_or_url Command or URL. If URL (http/https): Runs in SSE/StreamableHTTP client mode. If command string: Runs in SSE server mode, this is the default stdio server. If --named-server or --named-server-config is used, this can be omitted if no default server is desired. options: -h, --help show this help message and exit SSE/StreamableHTTP client options: -H, --headers KEY VALUE Headers to pass to the SSE server. Can be used multiple times. --transport {sse,streamablehttp} The transport to use for the client. Default is SSE. stdio client options: args Any extra arguments to the command to spawn the default server. Ignored if only named servers are defined. -e, --env KEY VALUE Environment variables used when spawning the default server. Can be used multiple times. For named servers, environment is inherited or passed via --pass-environment. --cwd CWD The working directory to use when spawning the default server process. Named servers inherit the proxy's CWD. --pass-environment, --no-pass-environment Pass through all environment variables when spawning all server processes. --debug, --no-debug Enable debug mode with detailed logging output. --named-server NAME COMMAND_STRING Define a named stdio server. NAME is for the URL path /servers/NAME/. COMMAND_STRING is a single string with the command and its arguments (e.g., 'uvx mcp-server-fetch --timeout 10'). These servers inherit the proxy's CWD and environment from --pass-environment. Can be specified multiple times. Ignored if --named-server-config is used. --named-server-config FILE_PATH Path to a JSON configuration file for named stdio servers. If provided, this will be the exclusive source for named server definitions, and any --named-server CLI arguments will be ignored. SSE server options: --port PORT Port to expose an SSE server on. Default is a random port --host HOST Host to expose an SSE server on. Default is 127.0.0.1 --stateless, --no-stateless Enable stateless mode for streamable http transports. Default is False --sse-port SSE_PORT (deprecated) Same as --port --sse-host SSE_HOST (deprecated) Same as --host --allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...] Allowed origins for the SSE server. Can be used multiple times. Default is no CORS allowed. Examples: mcp-proxy http://localhost:8080/sse mcp-proxy --transport streamablehttp http://localhost:8080/mcp mcp-proxy --headers Authorization 'Bearer YOUR_TOKEN' http://localhost:8080/sse mcp-proxy --port 8080 -- my-default-command --arg1 value1 mcp-proxy --port 8080 --named-server fetch1 'uvx mcp-server-fetch' --named-server tool2 'my-custom-tool --verbose' mcp-proxy --port 8080 --named-server-config /path/to/servers.json mcp-proxy --port 8080 --named-server-config /path/to/servers.json -- my-default-command --arg1 mcp-proxy --port 8080 -e KEY VALUE -e ANOTHER_KEY ANOTHER_VALUE -- my-default-command mcp-proxy --port 8080 --allow-origin='*' -- my-default-command

Beispielkonfigurationsdatei

{ "mcpServers": { "fetch": { "enabled": true, "timeout": 60, "command": "uvx", "args": [ "mcp-server-fetch" ], "transportType": "stdio" }, "github": { "timeout": 60, "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-github" ], "transportType": "stdio" } } }

Testen

Überprüfen Sie den mcp-proxy Server, indem Sie ihn mit dem mcp-server-fetch -Server ausführen. Sie können das Inspector-Tool verwenden, um den Zielserver zu testen.

# Run the stdio server called mcp-server-fetch behind the proxy over SSE mcp-proxy --port=8080 uvx mcp-server-fetch & # Connect to the SSE proxy server spawned above using another instance of mcp-proxy given the URL of the SSE server mcp-proxy http://127.0.0.1:8080/sse # Send CTRL+C to stop the second server # Bring the first server to the foreground fg # Send CTRL+C to stop the first server
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Ermöglicht die Interaktion mit Remote-MCP-Servern unter Verwendung von SSE-Transport anstelle von STDIO für erweiterte Kommunikationsfunktionen.

  1. Um
    1. stdio zu SSE/StreamableHTTP
      1. 1.1 Konfiguration
      2. 1.2 Anwendungsbeispiel
    2. SSE zu stdio
      1. 2.1 Konfiguration
      2. 2.2 Anwendungsbeispiele
    3. Benannte Server
      1. Installation
        1. Installation über Smithery
        2. Installation über PyPI
        3. Installation über das Github-Repository (neueste Version)
        4. Installation als Container
        5. Fehlerbehebung
      2. Erweitern des Container-Images
        1. Docker Compose-Setup
          1. Befehlszeilenargumente
            1. Beispielkonfigurationsdatei
          2. Testen

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              MCP server enabling LLMs to perform browser tasks via SSE transport, allowing clients like Cursor.ai and Claude to open websites and interact with web content through natural language commands.
              Last updated -
              • Apple
            • -
              security
              F
              license
              -
              quality
              A remote MCP server implementation for Cloudflare that uses server-sent events (SSE) to enable Model Control Protocol communication.
              Last updated -
              TypeScript
              • Linux
            • A
              security
              A
              license
              A
              quality
              The most powerful MCP server for Slack Workspaces. This integration supports both Stdio and SSE transports, proxy settings and does not require any permissions or bots being created or approved by Workspace admins 😏.
              Last updated -
              2
              282
              Go
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A reference implementation for creating an MCP server supporting Streamable HTTP & SSE Transports with OAuth authorization, allowing developers to build OAuth-authorized MCP servers with minimal configuration.
              Last updated -
              5
              TypeScript
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/sparfenyuk/mcp-proxy'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server