webstudio-ai-agent
🚀 Webstudio AI Agent & Local MCP Toolkit
AI 에이전트(Antigravity, Cursor, Claude Code, Windsurf)를 위한 완전한 자율 브리지로, 요금제 제한, API 한도, 접근 오류 없이 Webstudio MCP의 100% 기능을 로컬에서 열어줍니다.
🌟 주요 문제 및 해결책
Cloud API를 통한 일반적인 작업 | 우리의 자율 브리지 (Local MCP + Cloud Push) |
❌ 무료 요금제에서 차단됨 ( | ✅ 100% 무료, 제한 없음 |
❌ 유료 API 키 필요 | ✅ |
❌ 느림 (수십 개의 네트워크 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 리소스의 동적 컬렉션:
데이터 변수 생성:
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 installed
Maintenance
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
FlicenseNot gradedqualityBmaintenanceEnables AI agents to extract, sync, test, and debug Roblox games bidirectionally between Studio and filesystem via MCP.31- FlicenseBqualityCmaintenanceA 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
- AlicenseNot gradedqualityAmaintenanceEnables AI tools to read the Roblox Studio game tree, edit scripts, insert models, and run playtests via the Studio MCP interface.28MIT
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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