给一个兼容MCP的AI助手一个本地Chrome浏览器，它能打开， 导航、阅读和控制。

维护中： 该项目仍在变化中。main分支可能 比NPM上发布的包装更新。上方的NPM徽章显示 @latest使用的已发布版本。

它的作用

该软件包作为本地模型上下文协议（MCP）运行 服务器。你的MCP客户端启动服务器，服务器启动一个Chrome 浏览器自动化流程。

主要特点：

• 默认打开可见浏览器，可选无头模式
• 浏览页面并阅读HTML或文本
• 查找元素、点击、类型、等待和滚动
• 使用rebrowser-puppeteer-core和一小部分反侦测设置
• 在Windows、macOS和Linux上检测Chrome。
• 支持自定义 Chrome 路径、代理和专用自动化配置文件
• 跟踪其启动的Chrome进程，只关闭该进程
• 在页面交互前强制执行内容优先的工作流程

没有浏览器自动化是隐形的。网站仍可能检测到或屏蔽它。

安全与现行限制

请在使用服务器前阅读以下内容：

• 只在允许自动化的网站上使用。

Puppeteer Real Browser MCP Server

Give an MCP-compatible AI assistant a local Chrome browser that it can open, navigate, read, and control.

Under maintenance: This project is still changing. The main branch may be newer than the package published on npm. The npm badge above shows the published version used by @latest.

What it does

This package runs as a local Model Context Protocol (MCP) server. Your MCP client starts the server, and the server starts one Chrome process for browser automation.

Main features:

• Opens a visible browser by default, with optional headless mode
• Navigates pages and reads HTML or text
• Finds elements, clicks, types, waits, and scrolls
• Uses rebrowser-puppeteer-core and a small set of anti-detection settings
• Detects Chrome on Windows, macOS, and Linux
• Supports a custom Chrome path, proxy, and dedicated automation profile
• Tracks the exact Chrome process it starts and closes only that process
• Enforces a content-first workflow before page interaction

No browser automation is invisible. Websites may still detect it or block it.

Safety and current limits

Please read this before using the server:

• Use it only on websites you are allowed to automate.
• Review tool calls before approving logins, forms, purchases, downloads, or other sensitive actions.
• The browser and file tools run with your normal user permissions.
• The server supports one browser session at a time.
• solve_captcha is currently a placeholder. It does not use a CAPTCHA-solving service. Browser startup only makes a best-effort click on detected Turnstile widgets.
• save_content_as_markdown is listed by the server, but the current workflow validator blocks it. This is a known code issue.

Requirements

• Node.js 18 or newer
• npm and npx (included with the normal Node.js installer)
• Google Chrome or Chromium
• An MCP client that can start a local stdio server

Claude Desktop is available on macOS and Windows. Other MCP clients can use this server on Linux.

Quick start

You do not need to install this package globally. npx can download and run the published package when your MCP client needs it.

The -y option prevents an npm install question from blocking the MCP server while it starts.

Claude Desktop

1. Open Claude Desktop → Settings → Developer → Edit Config.
2. Add this server inside mcpServers:

{
  "mcpServers": {
    "puppeteer-real-browser": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-real-browser-mcp-server@latest"
      ]
    }
  }
}

1. Save the file.