MCP Chrome Server

by dlwjdtn535

4 stars
177 downloads
Not rated
GitHub

Description

# MCP Chrome Server [![smithery badge](https://smithery.ai/badge/@dlwjdtn535/mcp-chrome-server)](https://smithery.ai/server/@dlwjdtn535/mcp-chrome-server) [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow.svg)](https://buymeacoffee.com/dlwjdtn5…

About

# MCP Chrome Server [![smithery badge](https://smithery.ai/badge/@dlwjdtn535/mcp-chrome-server)](https://smithery.ai/server/@dlwjdtn535/mcp-chrome-server) [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow.svg)](https://buymeacoffee.com/dlwjdtn535) A Chrome server based on MCP…

Details

Author
dlwjdtn535
GitHub stars
4
Downloads
177
Categories
Web Scraping, Automation, Developer Tools, Other

- Browser control: open, navigate, and close Chrome
- Automated web login with CAPTCHA and 2FA handling
- Element manipulation: click, type, get text, get elements
- Secure credential management via system keychain
- Cross‑platform support: Windows, macOS, Linux

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Chrome Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via Smithery (npx -y @smithery/cli install @dlwjdtn535/mcp-chrome-server --client claude) or configure manually with uv and a JSON configuration for your OS. Set the CHROME_PROFILE_PATH environment variable to your Chrome profile directory, close all running Chrome instances, then use the provided tools (e.g., tool_open_browser, tool_navigate, tool_web_login).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp chrome server": {
            "mcp-chrome-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@dlwjdtn535/mcp-chrome-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-chrome-server": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@dlwjdtn535/mcp-chrome-server",
            "--client",
            "claude"
        ]
    }
}

MCP Chrome Server

smithery badge
Buy Me A Coffee

A Chrome server based on MCP (Model-Controller-Prompt) for browser automation.

Installation

Prerequisites

- Python 3.12 - Google Chrome browser installed - uv (Python package installer) or Docker

Installing via Smithery

npx -y @smithery/cli install @dlwjdtn535/mcp-chrome-server --client claude

Configuration Setup

Choose one of the following setup methods based on your environment:

1. Using uv (Recommended)

Windows Setup:

{
"mcpServers": {
"mcp-chrome-server": {
"command": "uv",
"args": [
"run",
"--directory",
"%LOCALAPPDATA%\\Programs\\mcp-chrome-server\\src",
"mcp-chrome-server"
],
"env": {
"CHROME_PROFILE_PATH": "%LOCALAPPDATA%\\Google\\Chrome\\User Data"
}
}
}
}

macOS Setup:

{
"mcpServers": {
"mcp-chrome-server": {
"command": "uv",
"args": [
"run",
"--directory",
"/usr/local/bin/mcp-chrome-server/src",
"mcp-chrome-server"
],
"env": {
"CHROME_PROFILE_PATH": "$HOME/Library/Application Support/Google/Chrome"
}
}
}
}

Linux Setup:

{
"mcpServers": {
"mcp-chrome-server": {
"command": "uv",
"args": [
"run",
"--directory",
"/usr/local/bin/mcp-chrome-server/src",
"mcp-chrome-server"
],
"env": {
"CHROME_PROFILE_PATH": "$HOME/.config/google-chrome"
}
}
}
}

Configuration

Chrome Profile Paths

Default Chrome profile paths for each operating system:

| OS | Path |
|---|---|
| Windows | %LOCALAPPDATA%\Google\Chrome\User Data |
| macOS | ~/Library/Application Support/Google/Chrome |
| Linux | ~/.config/google-chrome |

Important Notes

- Close all running Chrome instances before starting the automation server - Ensure proper permissions for the Chrome profile directory - For Docker setup, make sure the volume mount path matches your system's Chrome profile path

Credential Management

Securely store and manage login information using the system keychain:

```python

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.