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リクエスト) | ✅ Immerトランザクションによる即時生成(<500ms) |
❌ 機能が制限されている | ✅ 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つの選択肢)
オプション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への同期
ページの生成または編集が完了したら、1つのコマンドでプロジェクト全体をクラウドに同期します:
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