VULK MCP Server

Servidor MCP de VULK

El conector MCP de VULK permite a los asistentes de IA generar, editar, inspeccionar e implementar proyectos VULK desde el chat.

Posicionamiento: de indicación a sitio inmersivo. Los agentes pueden solicitar a VULK proyectos web 3D/WebGL, cinematográficos, ricos en video, impulsados por moodboards y full-stack, y recibir URLs de vista previa/editor/implementación.

Este paquete es el servidor MCP local stdio. El conector remoto público utiliza la misma superficie de herramientas en https://mcp.vulk.dev/mcp a través de HTTPS Streamable HTTP con OAuth 2.0 / PKCE.

Qué hace VULK

• Crea proyectos VULK de producción a partir de indicaciones en lenguaje natural.
• Genera experiencias web inmersivas utilizando el pipeline de generación interna de VULK.
• Edita proyectos existentes a partir de instrucciones de chat.
• Lista e inspecciona proyectos propiedad de la cuenta autenticada.
• Devuelve manifiestos de archivos de forma segura por defecto; el contenido debe solicitarse explícitamente.
• Implementa proyectos elegibles en producción.

El conector no expone claves API de proveedores, indicaciones internas, datos de clientes fuera de la cuenta autenticada, ni herramientas independientes de generación de medios en bruto.

Configuración rápida

URL del conector remoto para Claude/Codex/agentes que admitan MCP remoto:

https://mcp.vulk.dev/mcp

El endpoint remoto descubre OAuth a través de:

• https://mcp.vulk.dev/.well-known/oauth-protected-resource/mcp
• https://vulk.dev/.well-known/oauth-authorization-server

Configuración local stdio:

Obtén una clave API en https://vulk.dev/settings/api-keys.

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

Para entornos públicos/de revisión, desactiva los alias heredados para que los revisores vean solo los nombres de herramientas limpios:

{
  "env": {
    "VULK_API_KEY": "vk_sk_your_key_here",
    "VULK_ENABLE_LEGACY_TOOLS": "false"
  }
}

Herramientas principales

• create_visual_brief - convierte una idea en bruto, referencia visual, URL, Figma, captura de pantalla, referencia de video o moodboard en un brief de producción listo para VULK. Solo lectura.
• generate_immersive_site - genera un proyecto web VULK 3D/WebGL, cinematográfico, rico en video o impulsado por moodboard. Crea un proyecto y puede consumir créditos.
• create_project - genera un proyecto VULK general a partir de una indicación.
• edit_project - aplica un cambio en lenguaje natural a un proyecto VULK existente.
• list_projects - lista proyectos propiedad de la cuenta autenticada.
• get_project - obtiene metadatos del proyecto más URLs de vista previa/editor.
• get_project_files - obtiene un manifiesto de archivos del proyecto; el contenido es opcional, redactado y con límite de tamaño.
• deploy_project - implementa un proyecto en producción.
• list_models - lista los modelos VULK disponibles para la cuenta.
• get_usage - inspecciona créditos, uso y límites de tasa.
• subscribe - devuelve una URL de precios de VULK.

Los alias heredados (generate, edit, list, get, files, deploy, models, usage) permanecen habilitados por defecto para usuarios locales existentes. Establece VULK_ENABLE_LEGACY_TOOLS=false para la superficie del conector público.

Valores de seguridad por defecto

• Todas las herramientas llaman únicamente a las APIs de primera parte de VULK.
• La autenticación utiliza VULK_API_KEY para este paquete local. El MCP remoto usa OAuth 2.0 con PKCE, registro dinámico de clientes, tokens de acceso opacos con alcance y rotación de tokens de actualización.
• Las anotaciones de herramientas marcan operaciones de solo lectura, escritura y destructivas para clientes compatibles.
• get_project_files devuelve solo un manifiesto a menos que includeContent=true.
• Los archivos de apariencia sensible como .env, claves privadas, credenciales, archivos de cuentas de servicio, .npmrc y archivos de certificados/claves son redactados.
• Las respuestas de contenido de archivos están limitadas a 50 KB por defecto y 200 KB como máximo.
• El contexto de edición enviado de vuelta a VULK está limitado por VULK_MCP_MAX_EDIT_CONTEXT_BYTES y excluye rutas de apariencia sensible.
• El backend valida la propiedad del proyecto antes de la generación o mutación de archivos.

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
VULK_API_KEY	Sí	-	Clave API de VULK que comienza con vk_sk_.
VULK_API_BASE	No	https://vulk.dev	URL base de la API de VULK.
VULK_ENABLE_LEGACY_TOOLS	No	true	Establecer en false para la superficie de revisión pública.
VULK_MCP_MAX_EDIT_CONTEXT_BYTES	No	2000000	Contexto máximo seguro de archivos enviado para ediciones.

Objetivos de distribución

• Paquete MCP local: npx -y vulk-mcp-server
• MCP remoto: https://mcp.vulk.dev/mcp
• Registro oficial de MCP: server.json
• Smithery: smithery.yaml
• Glama: glama.json
• CLI de Gemini: gemini-extension.json
• Paquete de plugin de Codex: codex-plugin/
• Directorio de conectores de Claude: usa la compilación MCP OAuth remota descrita en docs/CLAUDE_CONNECTOR_SUBMISSION.md
• Extensiones/plugins de Codex: usa el plan de plugin y marketplace en docs/UNIVERSAL_AGENT_CONNECTOR.md

Desarrollo

npm install
npm run build
VULK_API_KEY=vk_sk_... node dist/index.js

Licencia

MIT