webstudio-ai-agent
🚀 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.
🌟 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 ( | ✅ 100% gratis y sin límites |
❌ Requiere claves API de pago | ✅ Funciona sin conexión directamente con |
❌ 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:
Creación de una variable de datos:
webstudio mcp single-op-call create-variable --input-file pricing_data.jsonConexió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
This server cannot be deployed
Maintenance
Related MCP Connectors
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.
Build and publish full-stack apps from your coding agent: models, rules, pages, auth, per-app MCP.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to interact with Roblox Studio via a token-efficient MCP server, live two-way script sync, and zero-friction plugin setup.-
- AlicenseNot gradedqualityAmaintenanceEnables AI tools to read the Roblox Studio game tree, edit scripts, insert models, and run playtests via the Studio MCP interface.21 npmMIT
- AlicenseNot gradedqualityBmaintenanceConnects 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 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceProvides a local-first AI workspace for chatting, invoking skills, managing projects, and integrating MCP tools, with all data stored on the user's machine.2Apache 2.0