MCP-S Gateway

Webrix MCP-S Gateway
Um gateway OAuth seguro e de código aberto para autenticação MCP

Gateway + camada de integração para o Model Context Protocol (MCP)

MCP-S Gateway

mcp-gateway é um gateway seguro e uma camada de integração para o Model Context Protocol (MCP). Ele fornece uma interface unificada e pronta para empresas para conectar, gerenciar e estender módulos e serviços MCP, com foco em segurança e integração perfeita.

Início Rápido

1. Configure seus servidores MCP - Crie o arquivo mcp.json no seu projeto:

{
  "mcpServers": {
    "your-server": {
      "command": "npx",
      "args": ["-y", "@your-mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    },
    "octocode": {
      "command": "npx",
      "args": ["octocode-mcp"]
    }
  }
}

2. Use o arquivo .env.example como base e substitua conforme necessário:

3. Inicie com npx (Recomendado):

# Default (uses ./mcp.json and ./.env)
npx @mcp-s/secure-mcp-gateway

# Custom configuration paths
npx @mcp-s/secure-mcp-gateway --mcp-config ./custom/mcp.json --envfile ./custom/.env

Ou clone:

git clone https://github.com/mcp-s-ai/secure-mcp-gateway.git && cd secure-mcp-gateway
npm install && npm run start

4. Adicione à sua configuração MCP:

stdio:

{
  "mcpServers": {
    "mcp-gateway": {
      "command": "npx",
      "args": ["-y", "@mcp-s/mcp"],
      "env": {
        "BASE_URL": "http://localhost:3000"
      }
    }
  }
}

Configuração HTTP Streamable:

{
  "mcpServers": {
    "mcp-gateway": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Recursos

• Gateway Auto-hospedado: Implante dentro da sua própria infraestrutura para máximo controle
• Autenticação OAuth: Autenticação segura com qualquer provedor OAuth via Auth.js
• Suporte a TypeScript: Totalmente tipado para desenvolvimento robusto

Suporta todos os tipos de conexão MCP:

• STDIO: Servidores MCP de entrada/saída padrão

• StreamableHTTP: Conexões de streaming baseadas em HTTP via http://localhost:3000/mcp (ou https://<your-domain>/mcp para implantações hospedadas)

  Seleção de Servidor: Você pode se conectar a um servidor MCP específico adicionando o parâmetro de consulta ?server_name=XXX, onde XXX é o nome do servidor da sua configuração mcp.json. Por exemplo: http://localhost:3000/mcp?server_name=your-server

  Conecte-se com seu cliente de IA preferido:

  Cliente	Link
  Claude	claude.ai
  Cursor	cursor.com
  Windsurf	codeium.com/windsurf
  VSCode	code.visualstudio.com
  Cline	cline.tools
  Highlight AI	highlightai.com
  Augment Code	augmentcode.com

Implantação

Implante o gateway mcp-s usando npx:

1. Configure suas variáveis de ambiente (veja Configuração Avançada)
2. Crie seu arquivo de configuração mcp.json
3. Execute npx @mcp-s/secure-mcp-gateway

Para implantações em produção, considere usar:

• Gerenciadores de processos como PM2: pm2 start "npx @mcp-s/secure-mcp-gateway" --name mcp-gateway
• Orquestração de contêineres (Docker, Kubernetes)
• Plataformas em nuvem (Heroku, Railway, Render)

Configuração de Autenticação

O mcp-gateway aproveita o poder do Auth.js, que suporta mais de 80 provedores OAuth prontos para uso. Isso torna o Auth.js o companheiro perfeito para um projeto de código aberto como o mcp-gateway. Ambas as bibliotecas compartilham o mesmo compromisso com flexibilidade, segurança e experiência do desenvolvedor. Ao integrar com o Auth.js, evitamos reinventar a roda da autenticação e, em vez disso, fornecemos fluxos OAuth testados em batalha e prontos para produção que funcionam perfeitamente entre provedores.

Basta definir a variável de ambiente AUTH_PROVIDER e fornecer as credenciais necessárias para o provedor escolhido - o mcp-gateway cuida do resto.

AUTH_SECRET=your-random-secret
AUTH_PROVIDER=google
AUTH_GOOGLE_ID=your-google-client-id
AUTH_GOOGLE_SECRET=your-google-client-secret

AUTH_SECRET=your-random-secret
AUTH_PROVIDER=okta
AUTH_OKTA_ID=your-okta-client-id
AUTH_OKTA_SECRET=your-okta-client-secret
AUTH_OKTA_ISSUER=https://your-okta-domain.okta.com/oauth2/default

AUTH_SECRET=your-random-secret
AUTH_PROVIDER=azure-ad
AUTH_AZURE_AD_ID=your-azure-client-id
AUTH_AZURE_AD_SECRET=your-azure-client-secret
AUTH_AZURE_AD_TENANT_ID=your-tenant-id-or-common

AUTH_SECRET=your-random-secret
AUTH_PROVIDER=github
AUTH_GITHUB_ID=your-github-client-id
AUTH_GITHUB_SECRET=your-github-client-secret
AUTH_GITHUB_SCOPES=repo

Para outros provedores, consulte a documentação de Provedores do Auth.js.

Configuração Avançada

Opções de Linha de Comando

Variáveis de Ambiente

Solução de Problemas

Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:sqlite

Solução Hospedada

Visite webrix.ai para nossa solução de hospedagem totalmente gerenciada com recursos avançados:

• Zero Configuração: Comece em segundos sem qualquer configuração
• Segurança de nível empresarial: Autenticação SSO avançada para todas as interações MCP
• Mais de 20 conectores pré-construídos: Integração rápida plug-and-play com centenas de ferramentas
• Funções e Permissões: Controle de acesso granular com definições de funções personalizadas
• Monitoramento e Análises: Insights em tempo real sobre seu uso de MCP
• Alta Disponibilidade: SLA de uptime de 99,9% com CDN global
• Suporte Premium: Acesso direto à nossa equipe de engenharia
• Integrações Personalizadas: Construa e implante conectores MCP personalizados

Comunidade

Tem perguntas? Precisa de ajuda para começar? Quer compartilhar sua configuração MCP?

Junte-se à nossa comunidade no Slack, onde desenvolvedores estão ajudando ativamente uns aos outros com implementações do gateway MCP, solução de problemas e compartilhamento de melhores práticas.

💬 Junte-se à nossa comunidade no Slack →

Licença

Lançado sob a Licença MIT. Contribuições são bem-vindas - dê uma estrela e faça um fork!