Blowback
@ESnark
About Blowback
MCP Server for Frontend dev environment (formerly known as vite-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": ""
}
}
}
}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
FAQ from Blowback
What development servers does Blowback support?
Blowback aims to support various FE development servers, not only Vite.
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.
Frequently asked questions
What development servers does Blowback support?
Blowback aims to support various FE development servers, not only Vite.
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.
Basic information
More Other MCP servers
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
AutoBrowser MCP
autobrowser-aiBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
Comments