What development servers does Blowback support?
Blowback aims to support various FE development servers, not only Vite.
Blowback MCP Server
@ESnark
Basic information
About Blowback MCP Server
MCP Server for Frontend dev environment (formerly known as vite-mcp-server)
Blowback MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"blowback": {
"command": "npx",
"args": [
"-y",
"blowback-context"
],
"env": {
"PROJECT_ROOT": ""
}
}
}
}Blowback MCP Server tools
16Description of how to use the server
Creates a new browser context with an auto-generated unique ID
Lists all active browser instances
Closes a specific browser instance
Gets detailed information about a specific browser instance
Gets usage statistics for browsers
Retrieves recent HMR events
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.
Retrieves properties and state information of a specific element
Retrieves style information of a specific element
Retrieves dimension and position information of a specific element
Monitors network requests in the browser for a specified duration
Retrieves the HTML content of a specific element and its children with optional depth control
Retrieves console logs from the development server
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.
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(); }"
Overview
What is Blowback?
Blowback is a Model Context Protocol (MCP) server that integrates front-end development servers (e.g., Vite) with AI tools like Claude Desktop and Cursor. It provides tools for browser automation, console log capture, HMR monitoring, and screenshot management.
How to use Blowback?
Install via npm as blowback-context. Add an MCP configuration entry (e.g., in .mcp.json or .cursor/mcp.json) specifying the command npx -y blowback-context and the optional environment variable PROJECT_ROOT (defaults to current working directory). Then use claude mcp add blowback -s project -e PROJECT_ROOT=/path/to/your/project -- npx -y blowback-context in Claude Code.
Key features of Blowback
- Integration of local development server with MCP server
- Browser console log capture and transmission via MCP
- Checkpoint-based log management for specific versions
- Screenshot capture and SQLite database management
- HMR (Hot Module Replacement) event monitoring
- Browser automation and element inspection tools
Use cases of Blowback
- Debugging front-end applications with AI assistants using live browser state
- Capturing and querying console logs across development checkpoints
- Inspecting and comparing DOM element properties and styles
- Monitoring HMR events and network requests during development
- Creating visual snapshots of pages for regression testing
Frequently asked questions
How are screenshots stored and managed?
Screenshot images are stored in `{PROJECT_ROOT}/.mcp_screenshot/` directory, and metadata is managed in a SQLite database in a temporary directory. It is recommended to add `.mcp_screenshot/` to `.gitignore`.
Does Blowback require a real browser?
Yes. It uses Playwright to control a Chrome browser instance for visual inspection, screenshot capture, and DOM manipulation.
What is the checkpoint system?
Checkpoints are named snapshots tied to a unique `data-id` in a `<meta name="__mcp_checkpoint" data-id="">` tag inserted into the page `<head>`. They allow separate recording of logs, screenshots, and DOM snapshots for specific versions.
Does Blowback support MCP prompts in all clients?
No. Cursor Chat does not support MCP prompt functionality; the `init` prompt is only available in Claude Code. If needed, users must manually input the prompt instructions.
More Other MCP servers
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
88.2K
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
14.8K
YOUB
Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
22.0K
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Comments