MCP-S Gateway

Webrix MCP-S Gateway
Una pasarela OAuth segura y de código abierto para la autenticación de MCP

Pasarela y capa de integración para el Protocolo de Contexto de Modelos (MCP)

MCP-S Gateway

mcp-gateway es una pasarela segura y una capa de integración para el Protocolo de Contexto de Modelos (MCP). Proporciona una interfaz unificada y lista para entornos empresariales para conectar, gestionar y extender módulos y servicios de MCP, con un enfoque en la seguridad y la integración sin interrupciones.

Inicio rápido

1. Configura tus servidores MCP - Crea el archivo mcp.json en tu proyecto:

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

2. Usa el archivo .env.example como base y anula lo que sea necesario:

3. Inicia con 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

O clona:

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

4. Añade a tu configuración de MCP:

stdio:

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

Configuración de HTTP transmisible:

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

Características

• Pasarela autoalojada: Despliega dentro de tu propia infraestructura para un control máximo
• Autenticación OAuth: Autenticación segura con cualquier proveedor de OAuth mediante Auth.js
• Soporte de TypeScript: Totalmente tipado para un desarrollo robusto

Soporta todos los tipos de conexión de MCP:

• STDIO: Servidores MCP de entrada/salida estándar

• StreamableHTTP: Conexiones de transmisión basadas en HTTP mediante http://localhost:3000/mcp (o https://<your-domain>/mcp para despliegues alojados)

  Selección de servidor: Puedes conectarte a un servidor MCP específico añadiendo el parámetro de consulta ?server_name=XXX, donde XXX es el nombre del servidor de tu configuración mcp.json. Por ejemplo: http://localhost:3000/mcp?server_name=your-server

  Conéctate con tu cliente de IA preferido:

  Cliente	Enlace
  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

Despliegue

Despliega la pasarela mcp-s usando npx:

1. Configura tus variables de entorno (consulta Configuración avanzada)
2. Crea tu archivo de configuración mcp.json
3. Ejecuta npx @mcp-s/secure-mcp-gateway

Para despliegues de producción, considera usar:

• Gestores de procesos como PM2: pm2 start "npx @mcp-s/secure-mcp-gateway" --name mcp-gateway
• Orquestación de contenedores (Docker, Kubernetes)
• Plataformas en la nube (Heroku, Railway, Render)

Configuración de autenticación

mcp-gateway aprovecha el poder de Auth.js, que soporta más de 80 proveedores de OAuth de forma nativa. Esto convierte a Auth.js en el compañero perfecto para un proyecto de código abierto como mcp-gateway. Ambas bibliotecas comparten el mismo compromiso con la flexibilidad, la seguridad y la experiencia del desarrollador. Al integrarnos con Auth.js, evitamos reinventar la rueda de la autenticación y, en su lugar, te proporcionamos flujos de OAuth probados en batalla y listos para producción que funcionan sin problemas en todos los proveedores.

Simplemente establece la variable de entorno AUTH_PROVIDER y proporciona las credenciales requeridas para tu proveedor elegido: mcp-gateway se encarga del 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 otros proveedores, consulta la documentación de Proveedores de Auth.js.

Configuración avanzada

Opciones de línea de comandos

Variables de entorno

Solución de problemas

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

Solución alojada

Visita webrix.ai para nuestra solución de alojamiento totalmente gestionada con características avanzadas:

• Configuración cero: Comienza en segundos sin ninguna configuración
• Seguridad de nivel empresarial: Autenticación SSO avanzada para todas las interacciones de MCP
• Más de 20 conectores preconstruidos: Integración rápida de plug-and-play con cientos de herramientas
• Roles y permisos: Control de acceso granular con definiciones de roles personalizados
• Monitoreo y análisis: Información en tiempo real sobre tu uso de MCP
• Alta disponibilidad: SLA de uptime del 99.9% con CDN global
• Soporte premium: Acceso directo a nuestro equipo de ingeniería
• Integraciones personalizadas: Construye y despliega conectores MCP personalizados

Comunidad

¿Tienes preguntas? ¿Necesitas ayuda para comenzar? ¿Quieres compartir tu configuración de MCP?

Únete a nuestra comunidad de Slack donde los desarrolladores se ayudan activamente entre sí con implementaciones de la pasarela MCP, solución de problemas y mejores prácticas.

💬 Únete a nuestra comunidad de Slack →

Licencia

Publicado bajo la Licencia MIT. ¡Las contribuciones son bienvenidas - dale estrella y haz un fork!