Skip to main content
Glama

블로우백

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 도구

도구 이름

설명

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 클라이언트에 도구를 제공하는 Model Context Protocol SDK 기반의 중앙 모듈입니다.

  2. 브라우저 자동화 : Puppeteer를 사용하여 Chrome을 제어하여 변경 사항을 시각적으로 검사합니다.

  3. 체크포인트 시스템 : 비교 및 테스트를 위해 브라우저 상태의 스냅샷을 유지합니다.

데이터 소스 및 상태 관리

서버는 여러 가지 중요한 데이터 저장소를 유지 관리합니다.

  • HMR 이벤트 기록 : Vite에서 발생한 최근 HMR 이벤트(업데이트, 오류)를 추적합니다.

  • 콘솔 메시지 로그 : 디버깅을 위해 브라우저 콘솔 출력을 캡처합니다.

  • 체크포인트 저장소 : DOM 스냅샷을 포함한 브라우저 상태의 명명된 스냅샷을 저장합니다.

커뮤니케이션 흐름

  1. MCP 클라이언트 → 개발 서버 :

    • MCP 클라이언트가 소스 코드를 변경하고 개발 서버가 변경 사항을 감지합니다.

    • 개발 서버는 브라우저를 업데이트하거나 HMR 이벤트를 자동으로 내보냅니다.

  2. 웹 브라우저 → 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