webstudio-ai-agent
🚀 Webstudio AI Agent & Local MCP Toolkit
Полноценный автономный мост для AI-агентов (Antigravity, Cursor, Claude Code, Windsurf), открывающий 100% возможностей Webstudio MCP локально без каких-либо ограничений тарифов, лимитов API или ошибок доступа.
🌟 Главная проблема и решение
Обычная работа через Cloud API | Наш автономный мост (Local MCP + Cloud Push) |
❌ Блокируется на бесплатных тарифах ( | ✅ 100% бесплатно и без лимитов |
❌ Требует платных API-ключей | ✅ Работает офлайн напрямую с |
❌ Медленно (десятки сетевых HTTP-запросов) | ✅ Мгновенная генерация (<500ms) благодаря Immer-транзакциям |
❌ Ограниченный функционал | ✅ Полная поддержка JSX, Radix UI, Animation Groups, Tokens, Collections |
Related MCP server: Roblox Studio MCP Server
🏗️ Архитектура (Как это работает)
┌───────────────────────────────────────────────────────────┐
│ 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 │
│ (Миттєве відображення результату в хмарі) │
└───────────────────────────────────────────────────────────┘⚡ Установка (2 варианта на выбор)
Вариант А: Локально в проект (Рекомендуется, изолированно)
# 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>"Вариант Б: Глобально на компьютер (Один раз для всех проектов)
# 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>"🛠️ Как пользоваться
1. Использование с AI-ассистентами (Antigravity / Cursor / Claude Code)
Просто откройте любой проект Webstudio в вашем редакторе.
Файлы AGENTS.md и .agents/skills/webstudio-ai-designer/SKILL.md автоматически объясняют AI-ассистенту все команды и правила генерации!
2. Примеры MCP-команд:
📄 Чтение страниц и элементов:
webstudio mcp single-op-call list-pages "{}"
webstudio mcp single-op-call list-instances '{"pagePath":"/services"}'
webstudio mcp single-op-call list-design-tokens "{}"🎨 Добавление секций через JSX (insert-fragment):
Создайте 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>"
}Выполните:
webstudio mcp single-op-call insert-fragment --input-file payload.json📊 Динамические коллекции из JSON-ресурса:
Создание переменной данных:
webstudio mcp single-op-call create-variable --input-file pricing_data.jsonПодключение динамической коллекции:
webstudio mcp single-op-call insert-collection --input-file collection.json🪟 Нативные 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>🎬 Нативные Webstudio Animation Groups (<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)" } }
]
}
]
}
}
]
}☁️ Синхронизация в Webstudio Cloud
Когда вы завершили генерацию или редактирование страниц, синхронизируйте весь проект в облако одной командой:
webstudio import --to "https://apps.webstudio.is/builder/<projectId>?authToken=<token>"📜 Лицензия
Этот проект распространяется под лицензией MIT.
Автор: 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