Vite MCP Server
ブローバック
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ツール
ツール名 | 説明 |
| 最近のHMRイベントを取得します |
| HMRステータスを確認します |
ブラウザツール
ツール名 | 説明 |
| ブラウザインスタンスを起動し、Vite開発サーバーに移動します |
| 現在のページまたは特定の要素のスクリーンショットをキャプチャします。スクリーンショットはディスクに保存されます。MCPクライアントの制限により、保存したスクリーンショット画像を編集ツールに手動で転送する必要がある場合があります。 |
| 特定の要素のプロパティと状態情報を取得します |
| 特定の要素のスタイル情報を取得します |
| 特定の要素の寸法と位置情報を取得します |
| 指定された期間、ブラウザ内のネットワークリクエストを監視します |
| 特定の要素とその子のHTMLコンテンツを取得します。 |
| オプションのフィルタリングを使用してブラウザセッションからコンソールログを取得します |
| 定義済みのブラウザコマンドを安全に実行します |
ツールの使い方
ツール名 | 説明 |
| ツールの使用方法の説明を提供します |
ログ管理システム
ログ管理方法
すべてのブラウザコンソールログはログファイルに保存されます
get-console-logsツールを使用して、特定のチェックポイントのログを照会できます。
チェックポイントシステム
チェックポイント操作方法
チェックポイントは、特定のバージョンのスナップショット、ログ、スクリーンショットなどを管理するために使用されます。
<meta name="__mcp_checkpoint" data-id="">``headに挿入されると、data-id属性を識別子としてデータが個別に記録されます。
アーキテクチャとデータフロー
コアコンポーネント
MCP サーバー: MCP クライアントにツールを提供する、モデル コンテキスト プロトコル SDK に基づく中心モジュール。
ブラウザ自動化: Puppeteer を使用して Chrome を制御し、変更を視覚的に検査します。
チェックポイント システム: 比較とテストのためにブラウザーの状態のスナップショットを維持します。
データソースと状態管理
サーバーはいくつかの重要なデータ ストアを維持します。
HMR イベント レコード: Vite からの最近の HMR イベント (更新、エラー) を追跡します。
コンソール メッセージ ログ: デバッグ用にブラウザー コンソールの出力をキャプチャします。
チェックポイント ストレージ: DOM スナップショットを含むブラウザー状態の名前付きスナップショットを保存します。
コミュニケーションフロー
MCPクライアント → 開発サーバー:
MCPクライアントがソースコードを変更し、開発サーバーがその変更を検出する
開発サーバーはブラウザを更新したり、HMRイベントを自動的に発行したりします。
Webブラウザ → MCPサーバー:
HMR イベントとコンソール ログは Puppeteer を通じてキャプチャされます。
MCPサーバーはブラウザの現在の状態を照会したり、スクリーンショットをキャプチャしたりします
MCP サーバー → MCP クライアント:
サーバーは HMR イベントを構造化された応答に変換します。
MCP クライアントが HMR ステータスを照会し、スクリーンショットをキャプチャするためのツールを提供します。
国家維持
サーバーは次の参照オブジェクトを維持します:
現在のブラウザとページインスタンス
最近のHMRイベント
Available Tools
16 toolsbrowser-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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
Hand off work between AI agents in any tool. Start Devin or Cursor cloud and share memory.
Give AI coding agents access to your Vynix visual feedback, bug reports, and AI diagnosis.
Let your AI agent build, preview and update web apps, download source and publish when you allow it.
Multiplayer AI rooms: bring your AI (Claude, ChatGPT, Cursor) into one shared room with your team.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceFacilitates integration with the Cursor code editor by enabling real-time code indexing, analysis, and bi-directional communication with Claude, supporting concurrent sessions and automatic reconnection.39MIT
- AlicenseBqualityDmaintenanceIntegrates front-end development servers with AI tools, enabling browser automation, console log capture, screenshot management, and HMR event monitoring.16MIT
- AlicenseNot gradedqualityCmaintenanceEnables interactive feedback sessions in Cursor with support for multiple chat tabs, clipboard (copy/paste images), and robust connection management across multiple windows.MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to delegate tasks to Cursor's headless agent, run adversarial reviews, and verify findings with prosecutor/advocate roles.MIT