Chrome MCP Server

Name: Chrome MCP Server
Author: adejaimejr

@adejaimejr

Repository

About Chrome MCP Server

Servidor MCP para integração entre extensão Chrome e Claude AI

#chrome-mcp-server #nodejs #devtools

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "chrome-mcp-server-adejaimejr": {
      "command": "npx",
      "args": [
        "github:adejaimejr/chrome-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.