Skip to main content
Glama

🚀 Webstudio AI Agent & Local MCP Toolkit

Un puente autónomo completo para agentes de IA (Antigravity, Cursor, Claude Code, Windsurf) que desbloquea el 100% de las capacidades de Webstudio MCP localmente, sin límites de tarifas, límites de API ni errores de acceso.

License: MIT Webstudio: Local MCP Node: >=18


🌟 El problema principal y la solución

Trabajo normal a través de Cloud API

Nuestro puente autónomo (Local MCP + Cloud Push)

❌ Se bloquea en tarifas gratuitas (FORBIDDEN)

✅ 100% gratis y sin límites

❌ Requiere claves API de pago

✅ Funciona sin conexión directamente con .webstudio/data.json

❌ Lento (decenas de solicitudes HTTP de red)

✅ Generación instantánea (<500ms) gracias a transacciones Immer

❌ Funcionalidad limitada

✅ Soporte completo para JSX, Radix UI, Animation Groups, Tokens, Collections


Related MCP server: Roblox Studio MCP Server

🏗️ Arquitectura (Cómo funciona)

┌───────────────────────────────────────────────────────────┐
│                    AI CODING ASSISTANT                    │
│        (Google Antigravity, Cursor, Claude Code)          │
└─────────────────────────────┬─────────────────────────────┘
                              │
                              ▼
┌───────────────────────────────────────────────────────────┐
│              LOCAL WEBSTUDIO MCP RUNTIME                  │
│       (70+ Official MCP Tools: insert-fragment, etc.)     │
└─────────────────────────────┬─────────────────────────────┘
                              │  (Fast Immer Local Mutation)
                              ▼
┌───────────────────────────────────────────────────────────┐
│               LOCAL PROJECT SOURCE OF TRUTH               │
│         .webstudio/data.json  &  .webstudio/assets/       │
└─────────────────────────────┬─────────────────────────────┘
                              │
                              ▼  webstudio import --to "<shareLink>"
┌───────────────────────────────────────────────────────────┐
│                  WEBSTUDIO CLOUD BUILDER                  │
│         (Миттєве відображення результату в хмарі)         │
└───────────────────────────────────────────────────────────┘

⚡ Instalación (2 opciones para elegir)

Opción A: Localmente en el proyecto (Recomendado, aislado)

# 1. Встановіть Webstudio локально в проект
npm i webstudio

# 2. Запустіть патчер
node scripts/setup-local-mcp.mjs --local

# 3. Завантажте проект із хмари
npx webstudio sync --link "<shareLink>"

# 4. Використовуйте MCP-інструменти для дизайну
npx webstudio mcp single-op-call list-pages "{}"

# 5. Відправте оновлений дизайн у хмару
npx webstudio import --to "<shareLink>"

Opción B: Globalmente en el ordenador (Una vez para todos los proyectos)

# 1. Встановіть глобально
npm i -g webstudio

# 2. Запустіть патчер
node scripts/setup-local-mcp.mjs

# 3. Завантажте проект із хмари
webstudio sync --link "<shareLink>"

# 4. Використовуйте MCP-інструменти для дизайну
webstudio mcp single-op-call list-pages "{}"

# 5. Відправте оновлений дизайн у хмару
webstudio import --to "<shareLink>"

🛠️ Cómo usarlo

1. Uso con asistentes de IA (Antigravity / Cursor / Claude Code)

Simplemente abra cualquier proyecto de Webstudio en su editor. Los archivos AGENTS.md y .agents/skills/webstudio-ai-designer/SKILL.md explican automáticamente al asistente de IA todos los comandos y reglas de generación.

2. Ejemplos de comandos MCP:

📄 Lectura de páginas y elementos:

webstudio mcp single-op-call list-pages "{}"
webstudio mcp single-op-call list-instances '{"pagePath":"/services"}'
webstudio mcp single-op-call list-design-tokens "{}"

🎨 Añadir secciones mediante JSX (insert-fragment):

Cree payload.json:

{
  "parentInstanceId": "<parent-instance-id>",
  "fragment": "<ws.element ws:tag='section' ws:tokens={[token('token-card', css`background: #fff; padding: 32px; border-radius: 16px;`)]} ws:style={css`display: flex; gap: 24px; @media (max-width: 767px) { flex-direction: column; }`}><ws.element ws:tag='h2'>Назва Секції</ws.element></ws.element>"
}

Ejecute:

webstudio mcp single-op-call insert-fragment --input-file payload.json

📊 Colecciones dinámicas desde un recurso JSON:

  1. Creación de una variable de datos:

webstudio mcp single-op-call create-variable --input-file pricing_data.json
  1. Conexión de la colección dinámica:

webstudio mcp single-op-call insert-collection --input-file collection.json

🪟 Componentes nativos de Radix UI (Dialog / Popups):

<radix.Dialog>
  <radix.DialogTrigger>
    <ws.element ws:tag='button'>Відкрити Попап</ws.element>
  </radix.DialogTrigger>
  <radix.DialogOverlay ws:style={css`position: fixed; inset: 0; background: rgba(0,0,0,0.5); backdrop-filter: blur(4px); display: flex; align-items: center; justify-content: center;`}>
    <radix.DialogContent ws:style={css`background: #fff; border-radius: 20px; padding: 32px; max-width: 500px;`}>
      <$.Box>
        <radix.DialogTitle>Заголовок Попапу</radix.DialogTitle>
        <radix.DialogDescription>Опис модального вікна</radix.DialogDescription>
      </$.Box>
      <radix.DialogClose>✕</radix.DialogClose>
    </radix.DialogContent>
  </radix.DialogOverlay>
</radix.Dialog>

🎬 Grupos de animación nativos de Webstudio (<animation.AnimateChildren>):

{
  "updates": [
    {
      "instanceId": "<animation-instance-id>",
      "name": "action",
      "type": "animationAction",
      "value": {
        "type": "view",
        "animations": [
          {
            "timing": {
              "duration": { "type": "unit", "value": 800, "unit": "ms" },
              "rangeStart": { "type": "unit", "value": 10, "unit": "%" },
              "easing": "ease-out",
              "fill": "backwards"
            },
            "keyframes": [
              { "offset": 0, "styles": { "opacity": "0", "transform": "translateY(40px)" } },
              { "offset": 1, "styles": { "opacity": "1", "transform": "translateY(0px)" } }
            ]
          }
        ]
      }
    }
  ]
}

☁️ Sincronización con Webstudio Cloud

Cuando haya terminado de generar o editar páginas, sincronice todo el proyecto a la nube con un solo comando:

webstudio import --to "https://apps.webstudio.is/builder/<projectId>?authToken=<token>"

📜 Licencia

Este proyecto se distribuye bajo la licencia MIT.

Autor: R0STEFAN

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to interact with Roblox Studio via a token-efficient MCP server, live two-way script sync, and zero-friction plugin setup.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Connects MCP-compatible AI clients and agents to one durable Project Brain plus controlled access to authorized project folders on your own machine. Enables file editing, terminal and Git operations, project intelligence, browser automation, and local MCP server federation, all scoped to explicit workspace grants.
    35 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides a local-first AI workspace for chatting, invoking skills, managing projects, and integrating MCP tools, with all data stored on the user's machine.
    2
    Apache 2.0