GenRocket MCP — Extensión de VS Code

Lleva GenRocket a VS Code: explorador de proyectos/escenarios/chains/dominios/generadores, descarga de escenarios .grs, ejecución del Runtime para generar datos, y un servidor MCP que expone todo como herramientas para el chat de IA (GitHub Copilot Chat).

Reúne en una sola extensión lo que antes vivía disperso: configuración + tools + MCP + runtime.

Características

• Explorador GenRocket (barra lateral): proyectos → versión → Escenarios / Chains / Dominios → atributos → generadores.
• Descargar escenario (.grs) desde el explorador (para el Runtime).
• Generar datos con el Runtime: descarga el .grs y ejecuta tu GenRocket Runtime local; los archivos generados quedan en la carpeta de salida.
• Plantilla CSV por dominio (columnas = atributos) para carga masiva.
• Servidor MCP: registra las herramientas de GenRocket en Copilot Chat para conversar en lenguaje natural (test conexión, listar proyectos/escenarios/chains/dominios/generadores, descargar, ejecutar Runtime).
• Credenciales seguras: la contraseña se guarda en el SecretStorage de VS Code (no en texto plano). El MCP la pide con un input seguro.
• Subir a GitHub (asistente paso a paso): conecta tu cuenta de GitHub, elige un repositorio, clónalo si hace falta, elige o crea una rama y sube tus cambios con un mensaje — todo guiado, en 5 pasos, sin comandos de git.

Subir mis cambios a GitHub (fácil)

Comando GenRocket: Subir mis cambios a GitHub (o el ícono de subida en el explorador). Un asistente con 5 pasos:

1. Conecta tu cuenta de GitHub (login propio de VS Code; puedes cambiar de cuenta).
2. Elige tu repositorio de la lista de tus repos.
3. Carpeta: si ya lo tienes abierto lo usa; si no, lo clona por ti.
4. Elige o crea una rama.
5. Escribe qué hiciste y pulsa Guardar y subir.

No se guardan tokens: usa tu sesión de GitHub de VS Code para autenticar el push.

Módulo de Base de Datos (consultas de solo lectura vía el agente)

Conecta a Oracle y SQL Server (varias bases, varias conexiones) y pregunta en lenguaje natural: "dame los usuarios activos". El agente explora el esquema (tablas, columnas, índices) y arma el SQL.

• Solo lectura: únicamente SELECT (bloquea INSERT/UPDATE/DELETE/DDL).
• Usa JDBC con tus propios drivers (ojdbc para Oracle, mssql-jdbc para SQL Server): no usa npm.
• Requiere Java instalado y la ruta a tu driver .jar.

Configura las conexiones en Settings → busca genrocket.dbConnections → "Edit in settings.json". Ejemplo:

"genrocket.dbConnections": [
  { "name": "prod-oracle", "type": "oracle",
    "jdbcUrl": "jdbc:oracle:thin:@//host:1521/servicio", "user": "usuario",
    "driverJar": "C:\\drivers\\ojdbc11.jar" },
  { "name": "reportes-mssql", "type": "sqlserver",
    "jdbcUrl": "jdbc:sqlserver://host:1433;databaseName=MiBD;encrypt=true;trustServerCertificate=true", "user": "sa",
    "driverJar": "C:\\drivers\\mssql-jdbc-12.6.1.jre11.jar" }
]

La contraseña no va aquí: al registrar/iniciar el MCP, VS Code la pide por un input seguro (una por conexión).

Tools MCP (en Copilot Chat): db_list_connections, db_test_connection, db_list_tables, db_describe_table, db_list_indexes, db_sample, db_query — todas de solo lectura y con parámetro connection para elegir la base.

Requisitos

• VS Code ^1.96
• Node.js 20+
• Java (para el GenRocket Runtime) y el GenRocket Runtime engine instalado (software propietario de GenRocket) si vas a generar datos.

Instalación (recomendada): desde el .vsix — sin npm

Ideal si tu red corporativa te da errores de certificado con npm (unable to get local issuer certificate). El .vsix ya trae todo (incluidas las dependencias del servidor MCP), así que no necesitas npm install.

1. Descarga el .vsix desde Releases.
2. En VS Code: Extensions → menú ··· (arriba a la derecha) → Install from VSIX… → elige el archivo.
3. Abre el panel GenRocket en la barra lateral y configura con el ícono de engrane.

¿Error "unable to get local issuer certificate" al conectar?

Es un proxy/CA corporativo que intercepta TLS (Zscaler / Netskope / CA de tu empresa). Node no confía en esa CA. Requiere la versión v0.1.1 o superior del .vsix.

Un "comando" aquí es de la Paleta de Comandos de VS Code, NO de la terminal. El comando detecta tu sistema operativo automáticamente.

macOS:

1. Presiona Cmd + Shift + P.
2. Escribe GenRocket: Preparar certificados corporativos y pulsa Enter.
3. Sale el aviso → cierra VS Code por completo con Cmd + Q y ábrelo de nuevo.
4. Vuelve a Probar conexión o a Registrar el MCP.

Windows:

1. Presiona Ctrl + Shift + P.
2. Escribe GenRocket: Preparar certificados corporativos y pulsa Enter.
3. Sale el aviso → cierra VS Code por completo (todas las ventanas) y ábrelo de nuevo.
4. Vuelve a Probar conexión o a Registrar el MCP.

En ambos, el comando exporta la CA de confianza del sistema (macOS = llavero; Windows = almacén de certificados Root) y configura NODE_EXTRA_CA_CERTS. El MCP ya incluye esa CA automáticamente.

Si no ves el comando al escribir "GenRocket", instala primero la v0.1.1 desde Releases (la v0.1.0 no lo trae).

flowchart TD
    A["Instala el .vsix v0.1.1"] --> B["Cmd + Shift + P"]
    B --> C["Escribe: GenRocket: Preparar certificados corporativos"]
    C --> D["Enter — genera la CA del llavero"]
    D --> E["Cmd + Q — cierra VS Code por completo"]
    E --> F["Abre VS Code otra vez"]
    F --> G["Probar conexion / Registrar MCP: OK"]

<!-- CAPTURAS: si quieres imágenes reales, colócalas en docs/images/ y descoméntalo: -->

No se apaga la verificación TLS: solo se confía en la CA que tu empresa ya instaló en tu llavero de macOS.

Diagnóstico opcional (esto SÍ es en la terminal) — para ver qué CA te intercepta:

echo | openssl s_client -connect app.genrocket.com:443 2>/dev/null | grep " i:"

Alternativa manual (solo si vas a usar npm compilando desde el código):

macOS / Linux (terminal):

security find-certificate -a -p /Library/Keychains/System.keychain > ~/corp-cacerts.pem
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain >> ~/corp-cacerts.pem
npm config set cafile ~/corp-cacerts.pem
export NODE_EXTRA_CA_CERTS=$HOME/corp-cacerts.pem

Windows (PowerShell):

Get-ChildItem Cert:\LocalMachine\Root, Cert:\CurrentUser\Root | ForEach-Object {
  '-----BEGIN CERTIFICATE-----'
  [Convert]::ToBase64String($_.RawData, 'InsertLineBreaks')
  '-----END CERTIFICATE-----'
} | Out-File -Encoding ascii "$HOME\corp-cacerts.pem"
npm config set cafile "$HOME\corp-cacerts.pem"
setx NODE_EXTRA_CA_CERTS "$HOME\corp-cacerts.pem"

Instalación (desde el código)

npm install            # dependencias de la extensión
npm run compile        # compila TypeScript a ./out
(cd mcp && npm install) # dependencias del servidor MCP

Luego abre la carpeta en VS Code y pulsa F5 (Extension Development Host), o empaqueta tu propio .vsix:

npm run package        # genera el .vsix (requiere @vscode/vsce)

Configuración

Cada usuario configura sus propios datos. La forma más clara es la ventana de configuración: comando GenRocket: Abrir configuración (o el ícono de engrane en el panel del explorador). Ahí pones tenant, usuario, contraseña, org id y el comando del Runtime, con botones para probar conexión y registrar el MCP.

• La contraseña se guarda cifrada en el SecretStorage de VS Code — nunca en el repositorio ni en texto plano.
• El chat de IA usa tu propia suscripción de GitHub Copilot; la extensión no guarda tokens de Copilot ni de OpenAI.
• Nada viene precargado con datos de otra organización: los valores por defecto son genéricos y editables por el usuario.

También puedes editar todo desde Settings → GenRocket MCP:

Ajuste	Descripción
genrocket.baseUrl	Host/tenant de tu organización, ej. https://TU-ORG.genrocket.com
genrocket.username	Usuario (email)
genrocket.organizationId	Organization external ID
genrocket.runtimeCommand	Comando del Runtime, con {grs} y {dir}. Ej: java -jar /ruta/GenRocketRuntime.jar {grs}
genrocket.runtimeOutputDir	Carpeta de salida del Runtime (vacío = temporal)

La contraseña se guarda con el comando GenRocket: Set Password (Command Palette).

Usar el chat de IA (MCP)

1. Ejecuta el comando GenRocket: Registrar servidor MCP (Copilot Chat). Escribe .vscode/mcp.json con la config y un input seguro para la contraseña.
2. Abre .vscode/mcp.json y pulsa Start en el servidor genrocket.
3. En Copilot Chat pídele, por ejemplo: "lista los dominios del proyecto UST_LOB_POC v2.0" o "genera datos del escenario X con el Runtime".

Herramientas MCP

genrocket_test_connection, genrocket_list_scenarios, genrocket_list_chains, genrocket_list_domains, genrocket_list_generators, genrocket_download_scenario, genrocket_runtime_status, genrocket_run_scenario.

Notas sobre GenRocket

• La autoría (crear dominios, atributos, generadores, receivers, diseñar escenarios) se hace en el GenRocket Designer; la REST API es de lectura/consumo.
• La generación de datos la realiza el GenRocket Runtime con la definición .grs; la nube no genera ni devuelve datos por REST.

Licencia

MIT