MCP Console Hub captures **everything** from your browser's console and streams it to your IDE's AI agent via the Model Context Protocol. No code changes needed.
mcp-console-hub
Your browser's DevTools, streamed to your IDE's AI agent.
What It Captures
| DevTools Tab | What's Captured | Details |
|--------------|----------------|---------|
| Console | console.error/warn/log/info/debug | With stack traces for errors/warnings |
| Console | Unhandled exceptions | window.onerror with file + line + column |
| Console | Promise rejections | unhandledrejection with stack |
| Network | All fetch/XHR requests | Method, URL, status, duration, headers, body preview, size |
| Network | Failed requests | 4xx, 5xx, connection errors with details |
| Application | localStorage | All key-value pairs |
| Application | sessionStorage | All key-value pairs |
| Application | Cookies | Name, value, domain, path |
| Application | IndexedDB | Database names |
| Performance | Navigation timing | TTFB, DOM loaded, load complete, DNS, connect |
| Performance | Resource loading | JS, CSS, images, fonts with duration + size |
| Performance | Memory | Heap size (Chrome only) |
| Performance | Marks & Measures | Custom performance marks |
Zero code changes. One bookmarklet. Works with any web app.
Quick Start
1. Configure your IDE
Cursor
{
"mcpServers": {
"mcp-console-hub": {
"command": "npx",
"args": ["-y", "mcp-console-hub@latest"]
}
}
}
VSCode
{
"servers": {
"mcp-console-hub": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-console-hub@latest"]
}
}
}
Claude Code
claude mcp add mcp-console-hub npx -y mcp-console-hub@latest
Antigravity / Windsurf / OpenCode
{
"mcpServers": {
"mcp-console-hub": {
"command": "npx",
"args": ["-y", "mcp-console-hub@latest"]
}
}
}
2. Connect your browser
Open http://localhost:3200 — drag the bookmarklet to your bookmarks bar.
Navigate to any web app. Click the bookmarklet.
3. Ask your AI agent
@mcp-console-hub Diagnose all errors and suggest fixes
@mcp-console-hub Show all network failures
@mcp-console-hub Read localStorage and explain the app state
@mcp-console-hub Audit page performance
@mcp-console-hub Fix errors by priority — most critical first
MCP Tools (24 tools)
Console (7 tools)
| Tool | Description |
|------|-------------|
| query_console | Filter by level, source, text, time, stack |
| get_entry_context | Full context with parsed stack frames + timeline |
| get_error_chains | Detect cascading errors (root cause analysis) |
| get_repeated_patterns | Find recurring messages |
| parse_stack_trace | Structured frames: function, file, line, col |
| find_by_file | Find all errors from a specific source file |
| get_unhandled_errors | Runtime exceptions + promise rejections |
Network (4 tools)
| Tool | Description |
|------|-------------|
| query_network | Filter by method, status, URL, duration |
| get_network_detail | Full request/response: headers, body, timing |
| get_network_errors | All 4xx, 5xx, and connection failures |
| get_slow_requests | Requests above duration threshold |
Storage (3 tools)
| Tool | Description |
|------|-------------|
| read_storage | All storage: localStorage, sessionStorage, cookies, IndexedDB |
| read_storage_key | Read specific key with auto JSON parse |
| get_cookies | List/search cookies |
Performance (2 tools)
| Tool | Description |
|------|-------------|
| get_performance | Navigation timing, resources, memory, marks |
| get_slow_resources | Find slow-loading JS, CSS, images, fonts |
General (4 tools)
| Tool | Description |
|------|-------------|
| get_console_stats | Aggregated statistics |
| get_page_info | Page URL, user agent, all data availability |
| get_timeline | Chronological event sequence |
| clear_console | Clear all captured data |
Export (1 tool)
| Tool | Description |
|------|-------------|
| export_report | Full DevTools report as JSON or Markdown |
MCP Prompts (7 prompts)
| Prompt | Trigger | Description |
|--------|---------|-------------|
| diagnose | /diagnose | Full analysis of errors + network + performance |
| fix_by_priority | /fix_by_priority | Prioritized fix list: Critical > High > Medium |
| suggest_solution | /suggest_solution | Concrete code fix for the most recent error |
| debug_network | /debug_network | Analyze failures, CORS issues, auth errors |
| read_app_state | /read_app_state | Analyze storage to understand app state |
| performance_audit | /performance_audit | Page load audit with optimization suggestions |
| fix_entry | /fix_entry | Step-by-step fix for the latest error |
MCP Resources (12 resources)
| URI | Description |
|-----|-------------|
| console://entries | All console entries |
| console://errors | Error-level only |
| console://warnings | Warning-level only |
| console://timeline | Chronological timeline |
| console://summary | Aggregated stats |
| network://requests | All network requests |
| network://errors | Failed requests |
| network://slow | Slow requests (>1s) |
| storage://snapshot | Full storage snapshot |
| storage://cookies | Cookies only |
| performance://data | All performance data |
| devtools://page | Page info + data availability |
How It Works
Browser (any web app) MCP Console Hub IDE AI Agent
+-----------------+ +--------------------+ +----------------+
| Bookmarklet | WebSocket | | stdio | |
| captures: |==============>| Console Store |<===========>| 24 MCP Tools |
| | :3201 | Network Store | | 12 Resources |
| - console.* | | Storage Snapshot | | 7 Prompts |
| - window.onerror| HTTP POST | Performance Data | | |
| - fetch/XHR |-------------->| | | Cursor |
| - localStorage | :3200 | File-backed | | VSCode |
| - cookies | | (.store/) | | Claude Code |
| - performance | | | | Antigravity |
+-----------------+ +--------------------+ +----------------+
zero code changes npx mcp-console-hub IDE MCP config
Ports & Environment
| Port | Protocol | Purpose | |------|----------|---------| | 3200 | HTTP | Connector page + health + ingestion | | 3201 | WebSocket | Real-time data streaming |
| Variable | Default | Description |
|----------|---------|-------------|
| MCP_CONSOLE_HUB_PORT | 3200 | HTTP port |
| MCP_CONSOLE_HUB_WS_PORT | 3201 | WebSocket port |
| MCP_CONSOLE_HUB_STORE_PATH | auto | Custom store file path |
License
MIT — see LICENSE