Skip to main content
Glama

🚀 Webstudio AI Agent & Local MCP Toolkit

Полноценный автономный мост для AI-агентов (Antigravity, Cursor, Claude Code, Windsurf), открывающий 100% возможностей Webstudio MCP локально без каких-либо ограничений тарифов, лимитов API или ошибок доступа.

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


🌟 Главная проблема и решение

Обычная работа через Cloud API

Наш автономный мост (Local MCP + Cloud Push)

❌ Блокируется на бесплатных тарифах (FORBIDDEN)

✅ 100% бесплатно и без лимитов

❌ Требует платных API-ключей

✅ Работает офлайн напрямую с .webstudio/data.json

❌ Медленно (десятки сетевых 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-ресурса:

  1. Создание переменной данных:

webstudio mcp single-op-call create-variable --input-file pricing_data.json
  1. Подключение динамической коллекции:

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

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