MCP Remote for Go

Name: MCP Remote for Go
Author: naotama2002

@naotama2002

关于 MCP Remote for Go

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

#mcp-remote-go #mcp-client #remote-connection

基本信息

分类

其他

许可证

MIT license

运行时

传输方式

stdio

发布者

naotama2002

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Remote for Go?

It is a Go implementation that proxies between a local MCP client using stdio transport and a remote MCP server using Server-Sent Events (SSE) with OAuth authentication. It enables MCP clients that only support local connections to reach remote servers securely.

How to use MCP Remote for Go?

Install by building from source or pulling the Docker image from GitHub Container Registry. Run as mcp-remote-go <remote-sse-url> [port] [--header ...] [--allow-http] or via Docker with docker run .... Configure MCP clients (Claude Desktop, Cursor, Windsurf) by editing their JSON config files to point to the binary or Docker command.

Key features of MCP Remote for Go

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.

Use cases of MCP Remote for Go

Connect a local MCP client to a remote MCP server requiring authentication.
Use Claude Desktop or Cursor with a cloud-hosted MCP server.
Securely proxy MCP traffic through OAuth without exposing tokens directly.
Integrate remote MCP services into local development workflows.

FAQ from MCP Remote for Go

How does authentication work?

On first connection to an auth‑requiring server, you are prompted to open a URL in your browser to authorize. The program waits for the OAuth flow, then stores tokens in ~/.mcp-auth for reuse.

How do I clear saved authentication data?

Run rm -rf ~/.mcp-auth to delete all stored OAuth tokens.

What if I have certificate issues behind a VPN?

Set the environment variable SSL_CERT_FILE to the path of your CA certificates file before running the program.

How do I use a different port for the OAuth callback?

Pass the port number as a second argument; e.g., mcp-remote-go https://remote.mcp.server/sse 9090. In Docker, map the container port accordingly.

Can I use HTTP instead of HTTPS?

Yes, use the --allow-http flag. This should only be done on trusted internal networks, as HTTPS is normally required.

其他分类下的更多 MCP 服务器

Awesome-MCP-ZH

yzfly

MCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients

7.4K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K