dazzle
dazzle
Dazzleの公式CLIおよびMCPサーバー — AIエージェントとライブストリーミングのためのクラウドステージ。
1つのバイナリで2つのインターフェースを提供します:
CLI — コーディングエージェント(Claude Code、Cursor、ターミナル)や自動化のためのフルシェルアクセス
MCPサーバー (
dazzle mcp) — サンドボックス化されたクライアント(Claude Desktop、VS Code、その他のMCPホスト)向けのstdio統合
インストール
macOS / Linux
curl -sSL https://dazzle.fm/install.sh | shWindows (PowerShell)
irm https://dazzle.fm/install.ps1 | iexその他のオプション
go install github.com/dazzle-labs/cli/cmd/dazzle@latestmacOS (arm64/amd64)、Linux (amd64/arm64)、Windows (amd64/arm64) 用のビルド済みバイナリはリリースページにあります。
Related MCP server: browser-gateway
クイックスタート (CLI)
dazzle login # authenticate (opens browser)
dazzle stage create my-stage # create a stage
dazzle stage up # activate — starts streaming
dazzle stage sync ./my-app --watch # push content, auto-refresh on changes
dazzle stage screenshot -o preview.png # verify output
dazzle destination add # add Twitch/Kick/custom RTMP
dazzle destination attach my-destination # go liveクイックスタート (MCP)
MCPクライアントの設定に追加してください:
{
"mcpServers": {
"dazzle": {
"command": "dazzle",
"args": ["mcp"]
}
}
}MCPサーバーは認証情報なしで起動します。エージェントは guide を呼び出してプラットフォームについて学び、cli ["login"] を呼び出して認証を行うことができます。
MCPツール
ツール | 説明 |
| dazzle CLIコマンドを実行します。利用可能なコマンドを確認するには |
| ステージワークスペース内のファイルを正確な文字列置換で編集します。old_stringはファイル内で一度だけ正確に一致する必要があります。現在の内容を確認するには、先に |
| Dazzleの完全なリファレンスを取得します — 開始方法、CLIコマンド、コンテンツ機能、ストリーミング設定など。ステージコンテンツを作成または変更する前に必ずお読みください。 |
| ステージワークスペース (~/.dazzle/stages/{stage}/) 内のすべてのファイルを一覧表示します。相対パスを1行ずつ返します。 |
| ステージワークスペース (~/.dazzle/stages/{stage}/{path}) からファイルを読み取ります。 |
| ステージの現在のブラウザ出力のスクリーンショットをキャプチャします。PNG画像を返します。 |
| ステージワークスペース (~/.dazzle/stages/{stage}/) をライブステージに同期します。ファイルを書き込んだ後にこれを実行してコンテンツをプッシュしてください。'dazzle stage sync {workspace-dir}' と同等です。 |
| ステージワークスペース (~/.dazzle/stages/{stage}/{path}) にファイルを書き込みます。必要に応じて親ディレクトリを作成します。ステージに同期可能なコンテンツを構築するために使用してください。 |
ワークスペースツール
ワークスペースツール (write_file、read_file、edit_file、list_files、sync) は、ホストファイルシステムの ~/.dazzle/stages/{stage-id}/ にファイルを保存します。これは、エージェントのbashが分離されたコンテナ内で実行され、CLIプロセスとファイルを共有できないサンドボックス環境(例:Claude Desktop)を橋渡しします。
ワークフロー: write_file → edit_file (反復) → sync → screenshot (確認)
制限事項: シェル/execは使用できません — ワークスペース内でビルドツール(npm、tailwindなど)を実行することはできません。コンテンツは事前にビルドされたHTML/CSS/JSである必要があります。完全なファイルシステムとシェルアクセス権を持つエージェント(例:Claude Code)は、完全な体験のために dazzle stage sync を直接使用してください。
MCPリソース
URI | 説明 |
| Dazzleの完全なリファレンス — 開始方法、CLIヘルプ、コンテンツ作成ガイド。 |
| Dazzleクイックスタートガイド — プラットフォームの概要、セットアップ、CLIの基本、ドキュメントリンク。 |
CLI vs MCP — どちらを使うべきか?
CLI | MCP | |
最適用途 | コーディングエージェント、ターミナル、CI/CD | Claude Desktop、VS Code、サンドボックスクライアント |
ファイルシステム | フルアクセス — どこにでも書き込み可能、ビルドツール実行可能 | ワークスペースのみ ( |
シェル | あり — npm、tailwind、あらゆるツールチェーン | なし — 事前にビルドされたコンテンツのみ |
コンテンツ同期 |
|
|
スクリーンショット |
|
|
認証 |
| MCP経由で |
CLIリファレンス
Usage: dazzle <command> [flags]
Dazzle — cloud stages for streaming.
A stage is a cloud browser environment that renders and streams your content.
Sync a local directory (must contain an index.html) and everything visible in
the browser window is what gets streamed to viewers.
Your content runs in a real browser with full access to standard web APIs (DOM,
Canvas, WebGL, Web Audio, fetch, etc.). localStorage is persisted across stage
restarts — use it to store app state that should survive between sessions.
Workflow:
1. dazzle login # authenticate (one-time)
2. dazzle s new my-stage # create a stage
3. dazzle s up # bring it up — starts streaming to Dazzle
4. dazzle s sync ./my-app -w # sync + auto-refresh on changes
5. dazzle s ss -o preview.png # take a screenshot to verify
6. dazzle s down # stop streaming and shut down
Auth: dazzle login, or set DAZZLE_API_KEY for headless/CI use. Stage selection:
use -s <name>, DAZZLE_STAGE env, or auto-selected if only one.
https://dazzle.fm
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
Commands:
version Print version information.
update Update dazzle to the latest release.
guide Show content authoring guide (rendering tips,
performance, best practices).
login Authenticate with Dazzle (opens browser).
logout Clear stored credentials.
whoami Show current user.
stage (s) list (ls) List stages.
stage (s) create (new) Create a stage.
stage (s) delete (rm) Delete a stage.
stage (s) up Activate a stage.
stage (s) down Deactivate a stage.
stage (s) status (st) Show stage status.
stage (s) stats Show live pipeline stats.
stage (s) preview Show the shareable preview URL for a running
stage.
stage (s) sync (sy) Sync a local directory to the stage. This is
the primary way to push content — use --watch
for live development.
stage (s) refresh (r) Reload the stage entry point.
stage (s) event (ev) emit (e) Push a named event with JSON data to
the running page — dispatched as a DOM
CustomEvent. Use this to send real-time data
from external processes (other agents, APIs,
etc.) without re-syncing or reloading.
stage (s) logs (l) Retrieve stage console logs.
stage (s) screenshot (ss) Capture a screenshot of the stage.
stage (s) info Get current stream title and category.
stage (s) title Set the stream title (not supported for
Restream).
stage (s) category Set the stream category or game (not
supported for Restream).
stage (s) chat send Send a message to live chat (not supported
for Restream).
destination (dest) list (ls) List broadcast destinations.
destination (dest) add (create,new)
Add a broadcast destination.
destination (dest) delete (rm)
Remove a broadcast destination.
destination (dest) attach (set)
Attach a destination to a stage.
destination (dest) detach (unset)
Detach a destination from a stage.
Run "dazzle <command> --help" for more information on a command.Usage: dazzle stage (s) <command> [flags]
Manage stages — create, sync content, screenshot, stream.
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
Commands:
stage (s) list (ls) List stages.
stage (s) create (new) Create a stage.
stage (s) delete (rm) Delete a stage.
stage (s) up Activate a stage.
stage (s) down Deactivate a stage.
stage (s) status (st) Show stage status.
stage (s) stats Show live pipeline stats.
stage (s) preview Show the shareable preview URL for a running
stage.
stage (s) sync (sy) Sync a local directory to the stage. This is
the primary way to push content — use --watch
for live development.
stage (s) refresh (r) Reload the stage entry point.
stage (s) event (ev) emit (e) Push a named event with JSON data to
the running page — dispatched as a DOM
CustomEvent. Use this to send real-time data
from external processes (other agents, APIs,
etc.) without re-syncing or reloading.
stage (s) logs (l) Retrieve stage console logs.
stage (s) screenshot (ss) Capture a screenshot of the stage.
stage (s) info Get current stream title and category.
stage (s) title Set the stream title (not supported for
Restream).
stage (s) category Set the stream category or game (not
supported for Restream).
stage (s) chat send Send a message to live chat (not supported
for Restream).stage sync フラグ
Usage: dazzle stage (s) sync (sy) <dir> [flags]
Sync a local directory to the stage. This is the primary way to push content —
use --watch for live development.
Arguments:
<dir> Local directory to sync (must contain an index.html entry point).
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
-w, --watch Watch for file changes and automatically re-sync.
--entry="index.html" HTML entry point file (default: index.html).stage screenshot フラグ
Usage: dazzle stage (s) screenshot (ss) [flags]
Capture a screenshot of the stage.
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
-o, --out=STRING Output file path (default: temp file).stage event サブコマンド
Usage: dazzle stage (s) event (ev) <command>
Send real-time data to the running page without reloading. Events are dispatched
as DOM CustomEvents — use this for async updates from subagents, APIs, or other
processes.
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
Commands:
stage (s) event (ev) emit (e) Push a named event with JSON data to
the running page — dispatched as a DOM
CustomEvent. Use this to send real-time data
from external processes (other agents, APIs,
etc.) without re-syncing or reloading.Usage: dazzle destination (dest) <command> [flags]
Manage broadcast destinations (Twitch, YouTube, etc).
Flags:
-h, --help Show context-sensitive help.
-j, --json Output as JSON.
-s, --stage=STRING Stage name or ID ($DAZZLE_STAGE).
--api-url=STRING API URL ($DAZZLE_API_URL).
Commands:
destination (dest) list (ls) List broadcast destinations.
destination (dest) add (create,new)
Add a broadcast destination.
destination (dest) delete (rm)
Remove a broadcast destination.
destination (dest) attach (set)
Attach a destination to a stage.
destination (dest) detach (unset)
Detach a destination from a stage.ステージの解決
ステージスコープのコマンドの場合、ステージは以下の順序で解決されます:
-s/--stageフラグまたはDAZZLE_STAGE環境変数ステージが1つしかない場合は自動選択
dazzle stage sync ./app --stage my-stage # explicit
export DAZZLE_STAGE=my-stage # or set for your session設定
環境変数 (設定ファイルや保存された認証情報よりも優先されます):
変数 | 目的 | デフォルト |
| APIキー — CI、スクリプト、単発コマンドで | |
| APIベースURL |
|
| ステージ名またはID | 1つのみの場合は自動選択 |
設定ファイル (~/.config/dazzle/、0600 パーミッション):
config.json # { "api_url": "..." }
credentials.json # { "api_key": "dzl_...", "email": "..." }セキュリティ
APIキーは
~/.config/dazzle/credentials.jsonに0600パーミッションで保存されますHTTPS経由でのみ
Bearerトークンとして送信されますログには記録されず、エコーもされず、第三者に送信されることもありません
テレメトリなし — 使用状況データ、クラッシュレポート、分析は一切ありません
すべてのソースコードはオープンソースであり、監査可能です
ライセンス
Apache 2.0 — LICENSE を参照してください
This server cannot be deployed
Maintenance
Related MCP Connectors
- TabfleetOAuthcom.tabfleet
Launch, inspect, control, and share isolated cloud browsers for your agents.
Cloud browsers for AI agents: get past bot detection, sign in with MFA, run web tasks at scale.
Cloud browsers for AI agents: saved logins, residential IPs, live human takeover, 57 browser tools.
Manage 24/7 live streams, media, playback queues, schedules, and multistreaming from AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceRemote browser instances for your AI agents. Reliably complete any browser-based task at scale. Fully-control agentic browsers that spin up in seconds.24 npm42Apache 2.0
- AlicenseNot gradedqualityAmaintenanceReliable, scalable browser infrastructure for AI agents. Route, pool, and failover across any browser provider. 8 built-in browser tools using raw Chrome CDP - navigate, screenshot, snapshot, interact, evaluate. Zero-config with auto Chrome detection & concurrent sessions support378 npm19MIT
- AlicenseNot gradedqualityBmaintenanceProvides AI agents with isolated virtual desktops containing a real Chromium browser, enabling them to see, click, type, and navigate like a human, with features like snapshots and remote control.25AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceCloud browser API with anti-detect engine + AI behavior layer. Session-based undetectable browsers for AI agents and developers.MIT