Vite MCP Server
블로우백
Vite MCP 서버가 이제 Blowback입니다.
Blowback은 Vite뿐만 아니라 다양한 FE 개발 서버를 지원하는 것을 목표로 합니다.
커서와의 통합을 지원하기 위해 FE 개발 서버에 MCP(Model Context Protocol) 서버를 추가합니다.
주요 특징
FE 개발 서버와 MCP 서버 통합
MCP를 통한 브라우저 콘솔 로그 캡처 및 전송
체크포인트 기반 로그 관리
Related MCP server: Blowback
설치
Cursor MCP 구성에 서버를 추가합니다.
지엑스피1
자원
콘솔 로그
브라우저 콘솔 로그를 검색하기 위한 리소스입니다.
참고: 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 클라이언트에 도구를 제공하는 Model Context Protocol SDK 기반의 중앙 모듈입니다.
브라우저 자동화 : Puppeteer를 사용하여 Chrome을 제어하여 변경 사항을 시각적으로 검사합니다.
체크포인트 시스템 : 비교 및 테스트를 위해 브라우저 상태의 스냅샷을 유지합니다.
데이터 소스 및 상태 관리
서버는 여러 가지 중요한 데이터 저장소를 유지 관리합니다.
HMR 이벤트 기록 : Vite에서 발생한 최근 HMR 이벤트(업데이트, 오류)를 추적합니다.
콘솔 메시지 로그 : 디버깅을 위해 브라우저 콘솔 출력을 캡처합니다.
체크포인트 저장소 : DOM 스냅샷을 포함한 브라우저 상태의 명명된 스냅샷을 저장합니다.
커뮤니케이션 흐름
MCP 클라이언트 → 개발 서버 :
MCP 클라이언트가 소스 코드를 변경하고 개발 서버가 변경 사항을 감지합니다.
개발 서버는 브라우저를 업데이트하거나 HMR 이벤트를 자동으로 내보냅니다.
웹 브라우저 → 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