convez.ai
MCP ServerDesenvolvimento WebIntermediário
shdomi8599

Vibie MCP

shdomi8599/vibie-mcp

Deploy de sites estáticos para vibie.page via Claude/Cursor

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite fazer deploy de pastas estáticas para URLs permanentes em `*.vibie.page` diretamente do Claude Desktop, Cursor ou qualquer cliente compatível com MCP. Integra autenticação OAuth 2.0 e gerenciamento de sites com histórico de versões.

Instalação

$npx convez-ai shdomi8599/vibie-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Publicar projetos web estáticos rapidamente durante conversas com IA
  • Compartilhar protótipos HTML/CSS/JS com URLs permanentes
  • Atualizar sites sem sair do editor de código ou cliente Claude

Veredito

MCP server bem estruturado para fluxo de deploy direto de IA. Autenticação OAuth 2.0 é segura, mas requer interação manual do usuário na primeira execução. Limitações de tamanho (100 MB/site, 500 arquivos) são razoáveis para estáticos.

README

A tradução para o português deste README ainda está na fila.

vibie-mcp

MCP server for Vibie — deploy static folders to permanent *.vibie.page URLs from Claude Desktop / Cursor / any MCP-compatible client.

Install

One-line auto setup (recommended)

npx vibie-mcp setup

Auto-detects Claude Desktop (Windows Store + APPDATA / macOS / Linux) and Cursor (~/.cursor/mcp.json) configs, then adds the vibie entry. Restart the client and you're done.

Manual config

If auto setup doesn't fit your client, add this to your MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, etc.):

{
  "mcpServers": {
    "vibie": {
      "command": "npx",
      "args": ["-y", "vibie-mcp"]
    }
  }
}

After saving, fully quit and restart your client.

First-time auth

On first tool call, the server initiates an OAuth 2.0 Device Authorization Grant. Your AI will receive instructions like:

Please open https://vibie.io/device?code=XXXX-YYYY in a browser, sign in with Google, and click Authorize. Then ask me to try again.

After authorizing in the browser, ask your AI to retry the same request. The server stores a token in ~/.vibie/credentials.json (chmod 0600) and reuses it for future calls.

You can revoke the token anytime at https://vibie.io/settings/api.

Tools

  • vibie_create_site — Upload a folder and create a new Vibie site. Auto-writes .vibie/site.json in the folder so future updates use the same site.
  • vibie_update_site — Re-deploy to an existing site. Reads slug from .vibie/site.json if not specified.
  • vibie_list_sites — List sites under your account.
  • vibie_get_site — Metadata for one site by slug.

How AI typically uses it

You: "Deploy this folder to vibie"
AI: → vibie_create_site({ folder: "." })
    → Returns: https://my-folder-x7f2.vibie.page

You: "Push my changes"
AI: Detects .vibie/site.json
    → vibie_update_site({ folder: "." })
    → Same URL, new content

Folder structure

What gets uploaded from a folder:

  • index.html + style.css + js/, assets/, etc — all included
  • Hidden files (.git, .vibie, .DS_Store) — automatically skipped
  • node_modules/ — skipped
  • Limits: 100 MB per site, 500 files per upload, 25 MB per file (Vibie's server validates)

A single HTML file (any name) also works — it gets auto-renamed to index.html on upload.

Env

VariableDefaultPurpose
VIBIE_API_BASEhttps://vibie.ioOverride for local dev (http://localhost:3000)

License

MIT

Ver o original no GitHub

Bom para

Relacionados