convez.ai
MCP ServerDevOps & InfraestruturaAvançado
edmcman

MCP Servers com OAuth 2.1

edmcman/mcp-servers

Hospedagem segura de MCP servers com OAuth 2.1 e ngrok

Ver no GitHub
InicialPluginScore · de 0 a 100

Hospeda múltiplos servidores MCP atrás de um único túnel ngrok com autenticação OAuth 2.1. Utiliza nginx para roteamento baseado em caminho, Ory Hydra para autorização, e supergateway para bridging de servidores stdio MCP para HTTP, garantindo que todos os endpoints compartilhem um domínio seguro.

Instalação

$npx convez-ai edmcman/mcp-servers

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Expor múltiplos MCP servers via HTTPS com autenticação centralizada
  • Integrar servidores MCP com Claude.ai e ChatGPT connectors de forma segura
  • Implementar OAuth 2.1 com PKCE e dynamic client registration para MCP

Veredito

Solução robusta para exposição segura de MCP servers em produção, com arquitetura bem fundamentada em OAuth 2.1 e componentes maduros (Hydra, nginx). Requer conhecimento sólido de Docker, networking e OAuth para operacionalizar.

README

A tradução para o português deste README ainda está na fila.

MCP Servers

Hosts one or more MCP servers behind a single ngrok tunnel, protected by OAuth 2.1.

Architecture

ngrok (static domain)
  └─► nginx :80  (path-based routing)
        ├─► hydra :4444/:4445  (OAuth 2.1, DCR, JWKS, tokens)
        └─► oauth-proxy :8080  (login/consent UI + JWT validation)
              └─► <server>-mcp:<port>  (supergateway, streamableHttp)
                    └─► MCP server process (stdio)

supergateway bridges each stdio MCP server to HTTP. nginx routes OAuth protocol endpoints to Ory Hydra and MCP traffic through oauth-proxy, so all servers share one ngrok domain while MCP endpoints require valid Bearer tokens.

Hydra provides OAuth 2.1 authorization, PKCE, dynamic client registration (DCR), JWKS, and JWT access tokens. oauth-proxy provides the simple login/consent UI, reads users from oauth/hydra/users.yml, and validates JWTs before forwarding MCP requests.

Endpoint

MyFitnessPal MCP is available at:

https://<your-domain>/mfp/mcp

Prerequisites

  • Docker and Docker Compose
  • A MyFitnessPal account
  • A free ngrok account with an authtoken and a static domain

Setup

1. Get ngrok credentials

  1. Sign up at ngrok.com (free)
  2. Copy your authtoken from the ngrok dashboard
  3. Claim a free static domain at Cloud Edge → Domains → New Domain

2. Configure environment

cp .env.example .env

Edit .env:

VariableDescription
MFP_USERNAMEMyFitnessPal email address
MFP_PASSWORDMyFitnessPal password
NGROK_AUTHTOKENToken from the ngrok dashboard
NGROK_DOMAINYour static domain, e.g. your-name.ngrok-free.app
HYDRA_DSNHydra database DSN, normally sqlite:///data/hydra.db?mode=rwc&_fk=true
HYDRA_SYSTEM_SECRET32+ character Hydra system secret

Users are configured in oauth/hydra/users.yml. The example username is user; change it there if needed. Passwords can be plaintext or bcrypt hashes; bcrypt is preferred.

cp oauth/hydra/users.example.yml oauth/hydra/users.yml
python3 -c "import bcrypt; print(bcrypt.hashpw(b'YOUR_PASSWORD', bcrypt.gensalt()).decode())"

Put the generated hash in the user's password field.

3. Build and run

docker compose build
docker compose up -d

Check logs:

docker compose logs -f

The MFP server is reachable once ngrok connects. Do not put credentials in the URL; OAuth handles authentication.

Connecting Clients

Use the MCP endpoint URL:

https://<your-domain>/mfp/mcp

Clients that support remote MCP OAuth, such as ChatGPT connectors and Claude.ai integrations, should discover OAuth metadata automatically, register via DCR, then redirect to the login UI. Use the username and password configured in oauth/hydra/users.yml.

Hydra remembers successful browser logins for 24 hours, so adding a second client in the same browser may not prompt for the password again.

Claude Code

Claude Code's HTTP MCP support may not perform the same OAuth connector flow as Claude.ai. If using Claude Code, add the unauthenticated URL only if your client supports OAuth for remote MCP:

claude mcp add myfitnesspal --transport http https://your-domain.ngrok-free.app/mfp/mcp

Stopping

docker compose down
Ver o original no GitHub

Bom para

Relacionados