Chrome MCP Server

What is Chrome MCP Server?

A Node.js server that bridges a Chrome DevTools extension with Cursor AI, enabling real-time debugging and monitoring of web applications. It captures console logs, errors, network requests, screenshots, and selected element data for use within Cursor’s MCP environment.

How to use Chrome MCP Server?

Install and run via npx github:adejaimejr/chrome-mcp-server on Windows, Linux, or Mac, or install globally with npm install -g github:adejaimejr/chrome-mcp-server. Then add the server command in Cursor under Settings > Extensions > MCP. The server automatically detects when run from Cursor and handles port allocation.

Key features of Chrome MCP Server

• Captures console logs and errors from Chrome
• Monitors network requests (successes and errors)
• Takes screenshots of the current page
• Inspects CSS and HTML of selected elements
• Wipes all stored logs on demand
• Automatic port fallback (3000 → 3001, etc.)
• Guarantees JSON-only output to prevent parsing errors

Use cases of Chrome MCP Server

• Debugging front‑end JavaScript errors during development
• Auditing failed network requests in real time
• Taking screenshots of UI states for documentation
• Inspecting DOM elements selected via Chrome DevTools
• Integrating browser telemetry directly into Cursor AI workflows

FAQ from Chrome MCP Server

Why do I see “Unexpected token” or JSON parsing errors?

This is fully resolved in v1.2.0 by intercepting all stdout/stderr and converting any non‑JSON output to valid JSON. Ensure you are using the latest version.

How does the server handle port conflicts?

If port 3000 is in use, the server automatically tries 3001, 3002, etc., up to ten attempts. You can also set a specific port via the PORT environment variable.

I get a “mkdir -p” or “chmod +x” error on Windows – what should I do?

Update to v1.2.0 which uses ES6 module scripts compatible with Windows. Alternatively, copy src/index.js manually to dist/mcp-server.js and add the shebang line.

Where does the data live? Is it exposed to the internet?

All data is stored locally on your machine and served via a local REST API. This server is intended for local development only and must not be exposed to the public internet.

What are the runtime dependencies?

Node.js 14+, Chrome 88+, and Cursor with MCP support. The server runs on the same machine as the browser and Cursor.