VULK MCP Server

Servidor MCP VULK

O conector MCP da VULK permite que assistentes de IA gerem, editem, inspecionem e implantem projetos VULK diretamente do chat.

Posicionamento: de prompt a site imersivo. Os agentes podem solicitar à VULK projetos web 3D/WebGL, cinematográficos, ricos em vídeo, orientados por moodboard e full-stack, e receber URLs de preview/editor/deploy.

Este pacote é o servidor MCP local via stdio. O conector remoto público usa a mesma superfície de ferramentas em https://mcp.vulk.dev/mcp via HTTPS Streamable HTTP com OAuth 2.0 / PKCE.

O que a VULK Faz

• Cria projetos VULK de produção a partir de briefs em linguagem natural.
• Gera experiências web imersivas usando o pipeline interno de geração da VULK.
• Edita projetos existentes a partir de instruções no chat.
• Lista e inspeciona projetos pertencentes à conta autenticada.
• Retorna manifestos de arquivos com segurança por padrão; o conteúdo deve ser solicitado explicitamente.
• Implanta projetos elegíveis em produção.

O conector não expõe chaves de API de provedores, prompts internos, dados de clientes fora da conta autenticada ou ferramentas independentes de geração de mídia bruta.

Configuração Rápida

URL do conector remoto para Claude/Codex/agentes que suportam MCP remoto:

https://mcp.vulk.dev/mcp

O endpoint remoto descobre OAuth através de:

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

Configuração local via stdio:

Obtenha uma chave de API em 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 ambientes públicos/de revisão, desative aliases legados para que os revisores vejam apenas os nomes de ferramentas limpos:

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

Ferramentas Principais

• create_visual_brief - transforma uma ideia bruta, referência visual, URL, Figma, screenshot, referência de vídeo ou moodboard em um brief de produção pronto para VULK. Somente leitura.
• generate_immersive_site - gera um projeto web VULK 3D/WebGL, cinematográfico, rico em vídeo ou orientado por moodboard. Cria um projeto e pode consumir créditos.
• create_project - gera um projeto VULK geral a partir de um prompt.
• edit_project - aplica uma alteração em linguagem natural a um projeto VULK existente.
• list_projects - lista projetos pertencentes à conta autenticada.
• get_project - obtém metadados do projeto além de URLs de preview/editor.
• get_project_files - obtém o manifesto de arquivos do projeto; o conteúdo é opcional, redigido e limitado em tamanho.
• deploy_project - implanta um projeto em produção.
• list_models - lista os modelos VULK disponíveis para a conta.
• get_usage - inspeciona créditos, uso e limites de taxa.
• subscribe - retorna uma URL de preços da VULK.

Aliases legados (generate, edit, list, get, files, deploy, models, usage) permanecem habilitados por padrão para usuários locais existentes. Defina VULK_ENABLE_LEGACY_TOOLS=false para a superfície pública do conector.

Padrões de Segurança

• Todas as ferramentas chamam apenas APIs próprias da VULK.
• A autenticação usa VULK_API_KEY para este pacote local. O MCP remoto usa OAuth 2.0 com PKCE, registro dinâmico de clientes, tokens de acesso opacos com escopo e rotação de refresh tokens.
• As anotações das ferramentas marcam operações somente leitura, gravação e destrutivas para clientes compatíveis.
• get_project_files retorna apenas um manifesto, a menos que includeContent=true.
• Arquivos com aparência sensível, como .env, chaves privadas, credenciais, arquivos de conta de serviço, .npmrc e arquivos de certificado/chave, são redigidos.
• As respostas de conteúdo de arquivo são limitadas a 50 KB por padrão e 200 KB no máximo.
• O contexto de edição enviado de volta à VULK é limitado por VULK_MCP_MAX_EDIT_CONTEXT_BYTES e exclui caminhos com aparência sensível.
• O backend valida a propriedade do projeto antes da geração ou mutação de arquivos.

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
VULK_API_KEY	Sim	-	Chave de API VULK começando com vk_sk_.
VULK_API_BASE	Não	https://vulk.dev	URL base da API VULK.
VULK_ENABLE_LEGACY_TOOLS	Não	true	Defina como false para a superfície pública de revisão.
VULK_MCP_MAX_EDIT_CONTEXT_BYTES	Não	2000000	Contexto máximo seguro de arquivo enviado para edições.

Alvos de Distribuição

• Pacote MCP local: npx -y vulk-mcp-server
• MCP remoto: https://mcp.vulk.dev/mcp
• Registro Oficial MCP: server.json
• Smithery: smithery.yaml
• Glama: glama.json
• CLI Gemini: gemini-extension.json
• Pacote de plugin Codex: codex-plugin/
• Diretório de Conectores Claude: use o build MCP OAuth remoto descrito em docs/CLAUDE_CONNECTOR_SUBMISSION.md
• Extensões/plugins Codex: use o plugin e o plano de marketplace em docs/UNIVERSAL_AGENT_CONNECTOR.md

Desenvolvimento

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

Licença

MIT