webstudio-ai-agent
🚀 Webstudio KI-Agent & Lokales MCP-Toolkit
Vollwertige autonome Brücke für KI-Agenten (Antigravity, Cursor, Claude Code, Windsurf), die 100% der Webstudio-MCP-Funktionen lokal öffnet, ohne jegliche Tarifbeschränkungen, API-Limits oder Zugriffsfehler.
🌟 Hauptproblem und Lösung
Normale Arbeit über Cloud-API | Unsere autonome Brücke (Local MCP + Cloud Push) |
❌ Wird bei kostenlosen Tarifen blockiert ( | ✅ 100% kostenlos und ohne Limits |
❌ Erfordert kostenpflichtige API-Schlüssel | ✅ Funktioniert offline direkt mit |
❌ Langsam (Dutzende Netzwerk-HTTP-Anfragen) | ✅ Sofortige Generierung (<500ms) dank Immer-Transaktionen |
❌ Eingeschränkter Funktionsumfang | ✅ Volle Unterstützung für JSX, Radix UI, Animation Groups, Tokens, Collections |
Related MCP server: Roblox Studio MCP Server
🏗️ Architektur (Wie es funktioniert)
┌───────────────────────────────────────────────────────────┐
│ 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 │
│ (Миттєве відображення результату в хмарі) │
└───────────────────────────────────────────────────────────┘⚡ Installation (2 Optionen zur Auswahl)
Option A: Lokal im Projekt (Empfohlen, isoliert)
# 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>"Option B: Global auf dem Computer (Einmal für alle Projekte)
# 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>"🛠️ So verwenden Sie es
1. Verwendung mit KI-Assistenten (Antigravity / Cursor / Claude Code)
Öffnen Sie einfach ein beliebiges Webstudio-Projekt in Ihrem Editor. Die Dateien AGENTS.md und .agents/skills/webstudio-ai-designer/SKILL.md erklären dem KI-Assistenten automatisch alle Befehle und Generierungsregeln!
2. Beispiele für MCP-Befehle:
📄 Lesen von Seiten und Elementen:
webstudio mcp single-op-call list-pages "{}"
webstudio mcp single-op-call list-instances '{"pagePath":"/services"}'
webstudio mcp single-op-call list-design-tokens "{}"🎨 Hinzufügen von Sektionen über JSX (insert-fragment):
Erstellen Sie 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>"
}Führen Sie aus:
webstudio mcp single-op-call insert-fragment --input-file payload.json📊 Dynamische Sammlungen aus JSON-Ressource:
Erstellen einer Datenvariable:
webstudio mcp single-op-call create-variable --input-file pricing_data.jsonAnbinden einer dynamischen Sammlung:
webstudio mcp single-op-call insert-collection --input-file collection.json🪟 Native Radix-UI-Komponenten (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>🎬 Native Webstudio-Animation-Gruppen (<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)" } }
]
}
]
}
}
]
}☁️ Synchronisierung in die Webstudio Cloud
Wenn Sie die Generierung oder Bearbeitung von Seiten abgeschlossen haben, synchronisieren Sie das gesamte Projekt mit einem einzigen Befehl in die Cloud:
webstudio import --to "https://apps.webstudio.is/builder/<projectId>?authToken=<token>"📜 Lizenz
Dieses Projekt wird unter der MIT-Lizenz verbreitet.
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