Skip to main content
Glama

ブローバック

Vite MCPサーバーは現在Blowbackです

BlowbackはViteだけでなく、様々なFE開発サーバーをサポートすることを目指しています。

Cursor との統合をサポートするために、FE 開発サーバーに Model Context Protocol (MCP) サーバーを追加します。

主な特徴

  • FE開発サーバーとMCPサーバーの統合

  • MCP 経由のブラウザ コンソール ログのキャプチャと送信

  • チェックポイントベースのログ管理

Related MCP server: Blowback

インストール

カーソル MCP 構成にサーバーを追加します。

{
  "blowback": {
    "command": "npx",
    "args": ["-y", "blowback-context"]
  }
}

リソース

コンソールログ

ブラウザ コンソールのログを取得するためのリソース。

注: MCPリソース機能は現時点ではCursorではサポートされていません。代わりにget-console-logsツールをご利用ください。

スクリーンショット

スクリーンショットをキャプチャして管理するためのリソース。

注: 他のリソースと同様に、これは現時点ではCursorで直接サポートされていません。代わりにcapture-screenshotツールをご利用ください。

ツール

HMRツール

ツール名

説明

get-hmr-events

最近のHMRイベントを取得します

check-hmr-status

HMRステータスを確認します

ブラウザツール

ツール名

説明

start-browser

ブラウザインスタンスを起動し、Vite開発サーバーに移動します

capture-screenshot

現在のページまたは特定の要素のスクリーンショットをキャプチャします。スクリーンショットはディスクに保存されます。MCPクライアントの制限により、保存したスクリーンショット画像を編集ツールに手動で転送する必要がある場合があります。

get-element-properties

特定の要素のプロパティと状態情報を取得します

get-element-styles

特定の要素のスタイル情報を取得します

get-element-dimensions

特定の要素の寸法と位置情報を取得します

monitor-network

指定された期間、ブラウザ内のネットワークリクエストを監視します

get-element-html

特定の要素とその子のHTMLコンテンツを取得します。

get-console-logs

オプションのフィルタリングを使用してブラウザセッションからコンソールログを取得します

execute-browser-commands

定義済みのブラウザコマンドを安全に実行します

ツールの使い方

ツール名

説明

how-to-use

ツールの使用方法の説明を提供します

ログ管理システム

ログ管理方法

  • すべてのブラウザコンソールログはログファイルに保存されます

  • get-console-logsツールを使用して、特定のチェックポイントのログを照会できます。

チェックポイントシステム

チェックポイント操作方法

  • チェックポイントは、特定のバージョンのスナップショット、ログ、スクリーンショットなどを管理するために使用されます。

  • <meta name="__mcp_checkpoint" data-id="">``headに挿入されると、data-id属性を識別子としてデータが個別に記録されます。

アーキテクチャとデータフロー

コアコンポーネント

  1. MCP サーバー: MCP クライアントにツールを提供する、モデル コンテキスト プロトコル SDK に基づく中心モジュール。

  2. ブラウザ自動化: Puppeteer を使用して Chrome を制御し、変更を視覚的に検査します。

  3. チェックポイント システム: 比較とテストのためにブラウザーの状態のスナップショットを維持します。

データソースと状態管理

サーバーはいくつかの重要なデータ ストアを維持します。

  • HMR イベント レコード: Vite からの最近の HMR イベント (更新、エラー) を追跡します。

  • コンソール メッセージ ログ: デバッグ用にブラウザー コンソールの出力をキャプチャします。

  • チェックポイント ストレージ: DOM スナップショットを含むブラウザー状態の名前付きスナップショットを保存します。

コミュニケーションフロー

  1. MCPクライアント → 開発サーバー:

    • MCPクライアントがソースコードを変更し、開発サーバーがその変更を検出する

    • 開発サーバーはブラウザを更新したり、HMRイベントを自動的に発行したりします。

  2. Webブラウザ → MCPサーバー:

    • HMR イベントとコンソール ログは Puppeteer を通じてキャプチャされます。

    • MCPサーバーはブラウザの現在の状態を照会したり、スクリーンショットをキャプチャしたりします

  3. MCP サーバー → MCP クライアント:

    • サーバーは HMR イベントを構造化された応答に変換します。

    • MCP クライアントが HMR ステータスを照会し、スクリーンショットをキャプチャするためのツールを提供します。

国家維持

サーバーは次の参照オブジェクトを維持します:

  • 現在のブラウザとページインスタンス

  • 最近のHMRイベント

Available Tools

16 tools
browser-evaluateB

Evaluates JavaScript code directly in the browser context and returns the result. Supports expressions, function strings, and complex code with automatic execution handling. Can target the entire page or work with element handles for precise DOM manipulation.

Examples:

  • Simple expression: "document.title"

  • Arrow function: "() => document.querySelectorAll('a').length"

  • Regular function: "function() { return document.body.children.length; }"

  • Function with arguments: "(tag) => document.getElementsByTagName(tag).length"

  • Complex code: "() => { const divs = document.querySelectorAll('div'); return { count: divs.length, hasClass: divs[0]?.className }; }"

  • Async function: "async () => { const res = await fetch('/api'); return res.json(); }"

Inputs: function (required), args, element, contextId, +2 more.

capture-screenshotA

Captures a screenshot of the current page or a specific element. Stores the screenshot in the MCP resource system and returns a resource URI. If ENABLE_BASE64 environment variable is set to 'true', also includes base64 encoded image in the response.

Inputs: selector, url, contextId.

close-browserB

Closes a specific browser instance

Inputs: contextId (required).

execute-browser-commandsB

Executes a sequence of predefined browser commands safely. Available commands:

  • click: Clicks on an element matching the selector or at specified coordinates

  • type: Types text into an input element

  • wait: Waits for an element, a specified time period, or a condition

  • navigate: Navigates to a specified URL

  • select: Selects an option in a dropdown

  • check: Checks or unchecks a checkbox

  • hover: Hovers over an element

  • focus: Focuses an element

  • blur: Removes focus from an element

  • keypress: Simulates pressing a keyboard key

  • scroll: Scrolls the page or an element

  • getAttribute: Gets an attribute value from an element

  • getProperty: Gets a property value from an element

  • drag: Performs a drag operation from one position to another

  • refresh: Refreshes the current page

Note on coordinates: For all mouse-related commands (click, drag, etc.), coordinates are relative to the browser viewport where (0,0) is the top-left corner. X increases to the right, Y increases downward.

Examples are available in the schema definition.

Inputs: commands (required), timeout, contextId.

get-console-logsB

Retrieves console logs from the development server

Inputs: checkpoint, limit.

get-context-infoC

Gets detailed information about a specific browser instance

Inputs: contextId (required).

get-context-statsC

Gets usage statistics for browsers

Inputs: contextId.

get-element-dimensionsB

Retrieves dimension and position information of a specific element

Inputs: selector (required).

get-element-htmlA

Retrieves the HTML content of a specific element and its children with optional depth control

Inputs: selector (required), includeOuter, depth.

get-element-propertiesB

Retrieves properties and state information of a specific element

Inputs: selector (required), properties (required).

get-element-stylesC

Retrieves style information of a specific element

Inputs: selector (required), styleProperties (required).

get-hmr-eventsC

Retrieves recent HMR events

Inputs: limit.

how-to-useD

Description of how to use the server

Inputs: section (required).

list-browsersA

Lists all active browser instances

Inputs: type, tags, includeStats.

monitor-networkA

Monitors network requests in the browser for a specified duration

Inputs: urlPattern, duration.

start-browserB

Creates a new browser context with an auto-generated unique ID

Inputs: type, displayName, targetUrl, headless, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: browser lifecycle (start, close, list), interaction (evaluate, screenshot, command sequence), inspection (element dimensions, HTML, properties, styles), and Vite-specific (console logs, HMR events, network monitor). No ambiguous overlap.

    Naming Consistency5/5

    All tool names use a consistent hyphenated lowercase verb-noun pattern (e.g., get-element-html, list-browsers, start-browser). Naming is predictable and uniform.

    Tool Count4/5

    16 tools is slightly above the ideal range of 3-15, but the set is well-scoped for the server's dual purpose of Vite dev server interaction and browser automation, without feeling bloated.

    Completeness5/5

    The tool set covers the full lifecycle (start, close, list), interactions (evaluate, screenshot, command sequences), element inspection, and Vite-specific diagnostics (console logs, HMR events, network monitoring). No obvious gaps for the intended use case.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers