🪓 Lumberjack - MCP Logger Factory

The Lumberjack Factory

🌲

Tree Cutting

Chrome browser generates console logs, errors, and activity

🚛

Log Hauling

Extension captures and transports logs to central MCP server

🏭

Mill Processing

MCP server validates, routes, and processes raw log data

📦

Quality Output

Formatted logs and screenshots delivered to Cursor for AI analysis

Lumber Mill Features

🔌

Chrome Extension

Automatically captures console logs, errors, network failures, and full-page screenshots from any webpage.

// Auto-captures logs and screenshots chrome.tabs.onUpdated.addListener( (tabId, changeInfo) => { if (changeInfo.status === 'complete') { captureFullPageScreenshot(tabId); } } );

🏗️

Central MCP Server

PostgreSQL-backed server that validates auth tokens and routes logs to project-specific ports.

POST /mcp/log { "auth_token": "64-char-token", "type": "error", "message": "TypeError: Cannot read...", "context": { "url": "...", "timestamp": "..." } }

🎯

Project Log Router

Receives routed logs and saves them to files, making them instantly available to your AI assistant.

// Project router saves logs app.post('/route-log', (req, res) => { const logEntry = `[${timestamp}] ${message}\n`; fs.appendFileSync('logs/mcp-logs.txt', logEntry); res.json({ status: 'log saved' }); });

📸

Screenshot Pipeline

Full-page screenshot capture with Chrome DevTools Protocol, automatically triggered on page loads.

// Full-page screenshot with fallback chrome.debugger.sendCommand(tabId, 'Page.captureScreenshot', { captureBeyondViewport: true }, (result) => uploadScreenshot(result.data) );

🔐

Secure Token Auth

64-character cryptographically secure tokens with project isolation and URL-based filtering.

// Registration with token { "auth_token": "853ae874b54e951ff...", "log_router_location": "/project/logs", "dev_urls": [""], "router_port": 4013 }

⚡

Real-time Processing

Sub-100ms log routing with efficient batching and minimal overhead on browser performance.

// Efficient log batching const logBatch = []; setInterval(() => { if (logBatch.length > 0) { sendLogBatch(logBatch); logBatch.length = 0; } }, 1000);

Live Logger Simulator

Watch Lumberjack in action as it processes logs from your browser to AI assistant:

[2024-01-20 14:30:45] 🌐 Chrome: Page loaded - https://myapp.com

[2024-01-20 14:30:46] 📸 Extension: Screenshot captured (1920x1080)

[2024-01-20 14:30:46] 🔄 MCP: Log routed to project port 4013

[2024-01-20 14:30:47] 💻 Cursor: AI analyzing new logs...

[2024-01-20 14:30:47] 📁 Router: Saved to mcp-logs.txt

Lumberjack