GDD (Giggly-Dazzling-Duckling)

# Run (headless, port 9700)
docker run -p 9700:9700 ghcr.io/cap-of-tea/gdd

# Or build locally
docker build -t gdd .
docker run -p 9700:9700 gdd

Docker イメージは、Chromium の依存関係がすべて事前にインストールされたヘッドレスモードで実行されます。

グローバル設定とプロジェクト設定は統合され、両方のサーバーを同時に利用できます。変更が反映されるのは、AI クライアントのセッションを再起動したときのみです。

VS Code ベースの IDE では、Claude Code / Cursor とは異なる形式の設定ファイルを使用します。

プロジェクト設定 — .vscode/mcp.json：

{
  "servers": {
    "gdd": {
      "type": "http",
      "url": "http://localhost:9700/mcp"
    }
  }
}

グローバル設定 — Cmd+Shift+P →「ユーザー設定を開く (JSON)」から開きます：

{
  "mcp": {
    "servers": {
      "gdd": {
        "type": "http",
        "url": "http://localhost:9700/mcp"
      }
    }
  }
}

グローバルな settings.json の場所：macOS — ~/Library/Application Support/<IDE>/User/settings.json、Linux — ~/.config/<IDE>/User/settings.json、Windows — %APPDATA%/<IDE>/User/settings.json。<IDE> はエディター名（Code、Windsurf、Antigravity など）に置き換えてください。

stdio-proxy の代替設定（.vscode/mcp.json）：

{
  "servers": {
    "gdd": {
      "type": "stdio",
      "command": "bash",
      "args": ["/absolute/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

デフォルトでは、Claude Code は MCP ツールを呼び出すたびに確認を求めます。確認なしで GDD ツールを使用できるようにするには、~/.claude/settings.json に追加します。

{
  "permissions": {
    "allow": [
      "mcp__gdd__*"
    ]
  }
}

このワイルドカードひとつで、GDD の全 39 ツールが対象になります。編集後、Claude Code を再起動してください。

プロキシスクリプトを使うと、AI クライアントの接続時に GDD が自動的に起動します。

Windows：

{
  "mcpServers": {
    "gdd": {
      "command": "powershell",
      "args": ["-ExecutionPolicy", "Bypass", "-File", "C:/path/to/Scripts/mcp-proxy.ps1"]
    }
  }
}

Linux / macOS：

{
  "mcpServers": {
    "gdd": {
      "command": "bash",
      "args": ["/path/to/Scripts/mcp-proxy.sh"]
    }
  }
}

CI/CD では、args 配列に "--headless" を追加してください。

ヒント： 初回起動時に、GDD は Chromium（約 80 MB）をダウンロードします。AI クライアントがタイムアウトする場合は、まず GDD を手動で起動してから再接続してください。

macOS（launchd）：

bash Scripts/install-launchd.sh            # headed (default)
bash Scripts/install-launchd.sh --headless  # for CI/CD

管理：launchctl list | grep gdd / bash Scripts/install-launchd.sh --uninstall

Linux（systemd）：

mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/gdd.service << 'EOF'
[Unit]
Description=GDD Multi-Browser Testing Server
[Service]
ExecStart=/path/to/GDD.Headless
WorkingDirectory=/path/to/gdd-directory
Restart=on-failure
[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now gdd

curl -X POST http://localhost:9700/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gdd_add_players","arguments":{"count":1}}}'

GDD は標準の JSON-RPC 2.0 を使用するため、curl、Python、Node.js、その他任意の HTTP クライアントで動作します。

スマートフォン（11）

タブレット（6）

デスクトップ（5）

BrowserXn.sln
├── src/
│   ├── GDD.Core/              ← Shared library (net8.0)
│   │   ├── Abstractions/      ← IBrowserEngine, IPlayerManager, ...
│   │   ├── Mcp/               ← MCP server, tools, protocol
│   │   ├── Models/            ← Device, Location, Network presets
│   │   ├── Services/          ← CDP, Emulation, Monitoring services
│   │   └── Collections/       ← RingBuffer
│   ├── BrowserXn/             ← Windows GUI (WPF + WebView2)
│   │   ├── Engines/           ← WebView2ControlAdapter
│   │   ├── ViewModels/        ← MVVM (MainViewModel : IPlayerManager)
│   │   ├── Views/             ← XAML + VideoWallPanel
│   │   └── ...
│   ├── GDD.Desktop/           ← Linux/macOS GUI (Avalonia + Playwright)
│   │   ├── Engines/           ← PlaywrightHeadedEngine (headed, parked off-screen)
│   │   ├── ViewModels/        ← MainViewModel (DesktopPlayerManager)
│   │   ├── Views/             ← AXAML + VideoWallPanel
│   │   └── Scripts/           ← mcp-proxy.sh, setup-macos.sh, install-deps.sh
│   └── GDD.Headless/          ← Cross-platform server (Playwright)
│       ├── Engines/           ← PlaywrightEngine
│       ├── Platform/          ← HeadlessPlayerManager
│       └── Scripts/           ← mcp-proxy.sh, mcp-proxy.ps1
└── .github/workflows/         ← CI/CD (8 build targets + auto-release)

実行ファイルと同じ場所にある appsettings.json：

{
  "GDD": {
    "FrontendUrl": "about:blank",
    "BackendUrl": "http://localhost:8080/api/v1",
    "BotToken": "",
    "McpPort": 9700,
    "DataFolderRoot": "",
    "Stealth": false
  }
}

コマンドラインフラグ

環境変数

appsettings.json ファイルの使用が難しい Docker や CI で便利です。

.NET 8 SDK が必要です。

# Windows GUI (requires Windows 10/11 + WebView2)
dotnet publish src/BrowserXn/BrowserXn.csproj -c Release -p:PublishSingleFile=true -o ./publish/win-gui

# Cross-platform headless
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r linux-x64 --self-contained -o ./publish/linux-x64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r osx-arm64 --self-contained -o ./publish/osx-arm64
dotnet publish src/GDD.Headless/GDD.Headless.csproj -c Release -r win-x64 --self-contained -o ./publish/win-x64

Chromium は初回実行時に自動的にインストールされます。

GDD はすべてローカルマシン上で動作します。テレメトリ、分析、データ収集は一切ありません。

• マシン外にデータが送信されることはありません — ブラウザープロファイル、スクリーンショット、ログ、Cookie はすべてローカルストレージに保存されます
• ブラウザープロファイル — %LOCALAPPDATA%\GDD\Profiles（Windows）または ~/.local/share/GDD/Profiles（Linux/macOS）に保存されます
• サードパーティサービスはありません — GDD は、任意の更新確認のために GitHub Releases にアクセスする場合を除き、外部 API に接続しません
• 更新確認 — gdd_check_update は api.github.com に読み取り専用のリクエストを1回送信します。このツールを呼び出さないか、appsettings.json で CheckForUpdates: false に設定すると、更新確認を無効にできます
• MCP サーバー — localhost のみで待ち受けます（デフォルトポートは 9700）。ネットワークに公開されることはありません

お問い合わせ先：[email protected]