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, conexión a bases de datos (Oracle/SQL Server, solo lectura), generación de datos sintéticos (Faker) y publicación de la data a tus repos de GitHub — todo expuesto como herramientas para el chat de IA (GitHub Copilot Chat) vía un servidor MCP.

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

Características

• Explorador GenRocket (barra lateral): proyectos → versión → Escenarios / Chains / Dominios → atributos → generadores.

• Descargar escenario (.grs) y generar datos con el Runtime local.

• Autoría por REST: crear dominios/atributos, agregar y parametrizar generadores, sugerir el generador adecuado por el nombre del atributo, y listar/crear receivers.

• Vista previa por REST: muestra datos de ejemplo de un dominio o atributo sin necesidad del Runtime (domain/preview).

• Bases de datos (Oracle / SQL Server): varias conexiones, exploración en lenguaje natural y consultas solo lectura. El módulo de configuración lista tus conexiones con estado y botón de prueba.

• Datos sintéticos con Faker: genera datos falsos rápidos (JSON/CSV/Excel) sin GenRocket.

• Sembrar datos reales + complemento sintético (Opción B): trae datos reales de la BD por SELECT (ej. pólizas) y completa cada fila con campos sintéticos (teléfono, email…).

• Publicar a N repos: sube la data generada (o un .md de contexto de un dominio) a uno o varios repositorios de GitHub con commit + push.

• Servidor MCP: registra todo en Copilot Chat para trabajar en lenguaje natural.

• Credenciales seguras: contraseñas en el SecretStorage de VS Code; el push usa tu sesión de GitHub de VS Code. Nada de tokens ni contraseñas en el repositorio.

Related MCP server: GeoServer MCP Server

Subir mis cambios a GitHub (asistente paso a paso)

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.

• El módulo de configuración (GenRocket: Abrir configuración) ahora lista tus conexiones registradas con su tipo, host/usuario, aviso de "sin contraseña" y un botón Probar por conexión, más un botón Administrar bases de datos.

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).

Nota sobre GenRocket y las conexiones de BD: GenRocket no expone por REST la lista de conexiones de base de datos dadas de alta en su plataforma (esas conexiones JDBC viven en la carpeta del Runtime). Por eso el plugin administra sus propias conexiones (las de arriba), que son las que el agente usa para traer datos reales.

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.

Datos sintéticos rápidos (Faker)

Módulo independiente para generar datos falsos sin GenRocket ni BD, exportables a JSON / CSV / Excel. Útil para datos desechables de prueba.

• faker_field_types: lista los tipos disponibles (firstName, email, phone, date, integer, address, etc.).

• faker_generate: define columnas {name, type}, cantidad de filas y formato. Idioma es (México) por defecto.

Ejemplo en Copilot Chat: "genera 50 usuarios con nombre, email, teléfono y edad entre 18 y 65 en Excel".

Sembrar datos reales de la BD y publicar a repos (Opción B)

Combina datos reales de tu base con complemento sintético y súbelos a uno o varios repositorios en un solo paso. Es el caso típico: tomar números y nombres de póliza reales y completar teléfono/email/dirección sintéticos.

Tool: seed_from_db_and_publish

Relación N↔N: una llamada puede subir a varios repos (varios destinos); y puedes tener varias publicaciones hacia el mismo repo con rutas distintas (varios dominios → un repo).

Ejemplo en Copilot Chat:

"Con la conexión prod-oracle, trae SELECT numero_poliza, nombre FROM polizas WHERE estatus='ACTIVA', renombra a policyNumber/policyHolder, agrega telefono y email sintéticos, formato csv, y súbelo a lrbg/appQA en test-data/polizas.csv y a lrbg/appRegresion en fixtures/polizas.csv."

Recomendación: primero haz un dry-run (sin repos) para revisar el archivo generado, y luego publica.

Documentar un dominio como Markdown de contexto

Convierte un dominio de GenRocket en un .md que sirve de contexto para el agente (y para el equipo): atributos, una muestra de datos y, opcionalmente, los generadores de cada atributo. Puede publicarse a repo(s).

Tool: domain_to_markdown — parámetros: projectName, domainName, version, sampleRows, includeGenerators, repos.

Ejemplo: "documenta el dominio Poliza del proyecto Prueba_APIS como markdown, con generadores, y súbelo a lrbg/appQA en docs/genrocket/poliza.md".

Todos los dominios de un proyecto + detección de patrones

Tool: project_domains_to_markdown — genera un .md por cada dominio del proyecto, más un índice (README.md) con una tabla de dominios y una sección de atributos compartidos entre dominios (mismo nombre en dos o más dominios = posible relación o patrón). Publica todo a un repo en un solo commit. Parámetros: projectName, version, domainNames (filtro opcional), sampleRows, includeGenerators, maxDomains, repos, basePath (default docs/genrocket).

Ejemplo: "documenta TODOS los dominios del proyecto UST_LOB_POC como contexto y súbelos a lrbg/appQA en docs/genrocket; quiero ver qué atributos comparten entre sí".

Publicación a repos: cómo autentica

El MCP hace commit + push con tu sesión de GitHub de VS Code: al registrar el servidor MCP, el plugin inyecta tu token de GitHub en la configuración local del MCP (nunca en el repositorio). Requisitos:

1. Tener GitHub conectado en VS Code (Accounts).

2. Ejecutar GenRocket: Registrar servidor MCP (o guardar la configuración) para que el token quede disponible, y hacer Restart del MCP.

Si el token no está disponible, la tool lo indica y no sube nada. Los repos se clonan/actualizan en ~/GenRocketRepos.

Manager Dashboard (Directiva N.4)

Tablero para el manager, protegido por palabra clave. Ábrelo con el icono de gráfica del panel de GenRocket (o el comando GenRocket: Manager Dashboard (Directiva N.4)): pedirá una palabra clave y, si es correcta, abre el tablero.

• Contraseña: se valida contra un hash guardado en el SecretStorage de VS Code (nunca en el repositorio). Cámbiala con GenRocket: Cambiar palabra clave del Dashboard.

• Qué muestra: KPIs (datasets, filas, dominios, repos, usuarios, última actividad); datos generados por dominio (dona + tabla); commits/publicaciones por usuario; actividad por usuario (resumen corto y descriptivo); salud (errores recientes + conexiones de BD). El botón Guardar .md exporta el tablero con gráficas mermaid.

• De dónde salen los datos: un registro de actividad que el plugin escribe en cada siembra/contexto (usuario, dominio, filas, formato, repos).

• Para todo el equipo: configura genrocket.dashboard.teamRepo (owner/nombre) y genrocket.dashboard.teamPath; cada persona sincroniza su actividad como <usuario>.jsonl en ese repo y el tablero agrega a todo el equipo. Sin configurarlo, el tablero es local.

Requisitos

• VS Code ^1.96

• Node.js 20+

• Java (para el Runtime y para el módulo de BD JDBC).

• El GenRocket Runtime engine instalado (software propietario de GenRocket) solo si vas a generar datos con el Runtime.

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"] --> 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"]

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, además de la lista de tus bases de datos con prueba por conexión.

• 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.

• El push a repos usa tu sesión de GitHub de VS Code (token inyectado en la config local al registrar el MCP; nunca en el repo).

• 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:

La contraseña de GenRocket 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 apuntando a la config local (incluye tu token de GitHub para el push).

2. Abre .vscode/mcp.json y pulsa Start (o Restart si ya estaba corriendo) en el servidor genrocket.

3. En Copilot Chat pídele, por ejemplo: "lista los dominios del proyecto UST_LOB_POC v2.0", "genera 100 pólizas reales + teléfono/email sintéticos y súbelas a mi repo de QA" o "documenta el dominio X como markdown".

Cada vez que cambies configuración, credenciales, conexiones de BD o tu cuenta de GitHub, vuelve a Registrar el MCP y haz Restart para que tome los cambios.

Herramientas MCP

GenRocket — consulta: genrocket_test_connection, genrocket_list_scenarios, genrocket_list_chains, genrocket_list_domains, genrocket_list_generators.

GenRocket — vista previa (genera muestra por REST, sin Runtime): genrocket_preview_domain, genrocket_preview_attribute.

GenRocket — autoría y generadores: crear dominio/atributos, agregar y parametrizar generadores, sugerir generador por nombre de atributo, listar/crear receivers.

GenRocket — descarga y ejecución: genrocket_download_scenario, genrocket_run_scenario, ejecución de chains y estado del Runtime (genrocket_runtime_status).

Bases de datos (solo lectura): db_list_connections, db_test_connection, db_list_tables, db_describe_table, db_list_indexes, db_sample, db_query.

Datos sintéticos (Faker): faker_field_types, faker_generate.

Siembra + publicación: seed_from_db_and_publish (datos reales + sintéticos → csv/json/xlsx → push a N repos), domain_to_markdown (un dominio → .md de contexto), project_domains_to_markdown (todos los dominios de un proyecto → un .md por dominio + índice con patrones → push opcional).

Notas sobre GenRocket

• El plugin puede autoría básica por REST (crear dominios, atributos, agregar y parametrizar generadores, receivers). El diseño avanzado sigue siendo más cómodo en el GenRocket Designer.

• La vista previa (domain/preview) genera una muestra por REST; para volumen completo con receivers se usa el GenRocket Runtime con la definición .grs.

• GenRocket no expone por REST la lista de conexiones de BD de su plataforma (viven en la carpeta JDBC del Runtime). La integración BD→GenRocket nativa se hace con los generadores de consulta (familia Query*), que requieren el Runtime + su configuración JDBC.

Licencia

MIT