Live Preview MCP Server

バージョン 1.1 (レッドチーム強化後) — MCP 対応 AI アシスタントがライブアプリケーションプレビューを起動・管理し、iframe に埋め込めるようにする本番グレードの Model Context Protocol サーバー。

セキュリティ強化 (v1.1)

• シェルインジェクションなし: Docker とプロセス生成は常に引数配列を使用します (shell: false)。

• 安全な環境: 環境変数の明示的な許可リストのみが渡されます。危険なキー (NODE_OPTIONS, LD_PRELOAD, など) は除去されます。

• シンボリックリンク安全なパスチェック: 許可リスト検証の前に realpathSync を実行します。

• WebSocket レート制限 + プレビューごとの接続上限。

• プロセス生存確認 (readiness): readiness プローブは子プロセスがまだ生きていることも検証します。

• 同時プレビュー制限 (デフォルト 10)。

• Docker: CapDrop: ALL, no-new-privileges、可能な場合は非 root ユーザー、AutoRemove + 起動時の孤児プロセスリーパー。

• より強力なログの秘匿化: JWT、AWS キー、GitHub/Slack/OpenAI トークンなど。

• トークン長の拡大: ランダムな 32 バイトに。

Related MCP server: Dynamic Code Executor MCP Server

機能

• MCP ツール: start_preview, stop_preview, get_preview_status, get_preview_logs, list_previews, reload_preview, update_preview_config, share_preview, get_mobile_qr, set_auth_token

• フレームワーク自動検出: Vite, Next.js, CRA, Vue, Angular, Express, static, Expo, Flutter

• HTTP ダッシュボード + フレーミングヘッダーを除去したリバースプロキシ

• オプション: Docker、Cloudflare/ngrok トンネル、モバイル QR、トークン認証、Cloud-IDE 対応

要件

• Node.js ≥ 18

• オプション: Docker、cloudflared、ngrok

インストール & ビルド

cd live-preview-mcp
npm install
npm run build

実行

node dist/index.js

MCP クライアント設定

{
  "mcpServers": {
    "live-preview": {
      "command": "node",
      "args": ["/absolute/path/to/live-preview-mcp/dist/index.js"],
      "env": {
        "PORT": "9000",
        "ALLOWED_DIRS": "/path/to/projects"
      }
    }
  }
}

ライセンス

MIT