MCP Remote for Go

by naotama2002

239 downloads Not rated yet MIT license
GitHub

About

This Go implementation allows MCP clients that only support local (stdio) connections to connect to remote MCP servers with authentication support.

Details

License
MIT license

Explore

- Bridges local stdio MCP clients to remote SSE servers.
- Supports OAuth authentication with browser-based authorization.
- Stores OAuth tokens in ~/.mcp-auth for reuse.
- Compatible with Claude Desktop, Cursor, and Windsurf.
- Allows custom HTTP headers and optional HTTP (--allow-http).
- Available as binary or Docker image from GitHub Container Registry.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Remote for Go
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


mcp-remote-go https://remote.mcp.server/sse

bash

docker run --rm -it -p 3334:3334 ghcr.io/naotama2002/mcp-remote-go:latest https://remote.mcp.server/sse

The first time you connect to a server requiring authentication, you'll be prompted to open a URL in your browser to authorize access. The program will wait for you to complete the OAuth flow and then establish the connection.

Authorization tokens are stored in ~/.mcp-auth/ and will be reused for future connections.

If you're having issues with authentication, you can clear the stored data:

rm -rf ~/.mcp-auth

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp remote for go": {
            "mcp-remote-go": {
                "command": "docker",
                "args": [
                    "pull",
                    "ghcr.io/naotama2002/mcp-remote-go:latest"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-remote-go": {
        "command": "docker",
        "args": [
            "pull",
            "ghcr.io/naotama2002/mcp-remote-go:latest"
        ]
    }
}

This Go implementation allows MCP clients that only support local (stdio) connections to connect to remote MCP servers with authentication support.

Overview

MCP Remote proxies between:
- A local MCP client using stdio transport
- A remote MCP server using Server-Sent Events (SSE) with OAuth authentication

Installation

Building from Source

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.