Home / MCP / Browser MCP Server

Browser MCP Server

Provides browser-interaction tools to read pages, apply styles, and search history via an MCP client.

typescript

84stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "browser_mcp": {
            "command": "npx",
            "args": [
                "@djyde/mcp-browser@latest"
            ]
        }
    }
}

The browser MCP server lets you interact with the browser you’re using by exposing a set of tools you can call from MCP clients. It focuses on automating browser tasks such as reading the current page, injecting styles, and searching history, all through a simple, scriptable interface.

How to use

You connect an MCP client to this server to perform browser actions from your tooling. The server configuration shown below uses a local, stdio-based setup that runs a command to invoke the browser MCP extension. Once the server is running, your client can call the available tools to read the current page content, style the page, or search your history.

To start, run the provided MCP command in your environment to launch the browser MCP extension as a local server. Then configure your MCP client to use this server for browser interactions. You can call the tools in sequence to capture page content, apply CSS themes, and query your history as part of your automation workflows.

How to install

Prerequisites you need before installing this MCP server are Node.js and npm (or a compatible Node package manager). You may also use pnpm if you prefer a faster, space-efficient install.

# Install dependencies for the MCP setup
pnpm i

# Build the server components if you are integrating the MCP server locally
cd server
npm run build

# Run the MCP server in development mode
cd server
npm run dev

Additional setup notes

The standard MCP connection for this server is a stdio configuration that uses the npx invocation to run the extension. You can embed this in your MCP client setup so that the client launches the browser MCP extension with the appropriate arguments.

{
  "mcpServers": {
    "browser_mcp": {
      "command": "npx",
      "args": ["@djyde/mcp-browser@latest"]
    }
  }
}

Available tools

get_current_page_markdown

Retrieve the markdown content from the current browser page to capture or summarize what you are viewing.

append_style

Attach a CSS style to the current browser page to modify its appearance, such as enabling dark mode or applying custom themes.

history_search

Search the browser history to find matching entries, enabling quick navigation to previously visited pages.