Skip to main content
Glama

🚀 Webstudio AI 代理与本地 MCP 工具包

为 AI 代理(Antigravity、Cursor、Claude Code、Windsurf)提供完整的自主桥梁,在本地解锁 Webstudio MCP 的 100% 功能,不受任何套餐限制、API 限额或访问错误的约束。

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


🌟 核心问题与解决方案

通过 Cloud API 的常规工作方式

我们的自主桥梁(本地 MCP + 云端推送)

❌ 在免费套餐下被阻止(FORBIDDEN

100% 免费且无限制

❌ 需要付费 API 密钥

✅ 离线直接使用 .webstudio/data.json

❌ 速度慢(数十次网络 HTTP 请求)

即时生成(<500ms),得益于 Immer 事务

❌ 功能受限

完整支持 JSX、Radix UI、Animation Groups、Tokens、Collections


Related MCP server: OGSync

🏗️ 架构(工作原理)

┌───────────────────────────────────────────────────────────┐
│                    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 种方案可选)

方案 A:本地安装到项目中(推荐,隔离环境)

# 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>"

方案 B:全局安装到计算机(一次安装,适用于所有项目)

# 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

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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.
  • F
    license
    B
    quality
    C
    maintenance
    A fully local, privacy-first MCP server that gives AI coding assistants deep repository intelligence with file-and-line-cited answers, persistent semantic memory, and agentic abilities like task planning and code review—all without any cloud API calls.
    23

View all related MCP servers

Related MCP Connectors

  • Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

  • MCP-native collaborative markdown editor with real-time AI document editing

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/R0STEFAN/webstudio-ai-agent'

If you have feedback or need assistance with the MCP directory API, please join our Discord server