browser-mcp logo

browser-mcp

by djyde

browser-mcp is a browser extension and MCP server that allows you to interact with the browser you are using. It provides tools to manipulate and extract information from the current browsing page.

View on GitHub

Last updated: N/A

What is browser-mcp?

browser-mcp is a system comprised of a browser extension and an MCP (Message Control Protocol) server. The extension allows the server to interact with and control the browser, enabling automated tasks and data extraction.

How to use browser-mcp?

  1. Build the extension for your browser (Chrome, Edge, or Firefox) using the provided build commands. 2. Build and run the MCP server. 3. Configure an MCP server (e.g., Playwright) to use the built server. 4. Use the available tools (e.g., get_current_page_markdown, append_style, history_search) by sending commands to the MCP server.

Key features of browser-mcp

  • Interact with the browser programmatically

  • Extract markdown from web pages

  • Append CSS styles to web pages

  • Search browser history

  • Extensible with custom tools

Use cases of browser-mcp

  • Automated web scraping

  • Browser automation for testing

  • Custom browser extensions

  • Content summarization

  • Accessibility enhancements

FAQ from browser-mcp

How do I add a new tool?

Add the tool schema to server/src/tools.ts, a callable handler in extension/calls.ts, and a tool handler in server/src/tools.ts.

Where can I find the available tools?

All available tools are listed in server/src/tools.ts.

How do I build the extension?

Navigate to the extension directory and run npm run build for Chrome, npm run build:edge for Edge, or npm run build:firefox for Firefox.

How do I run the MCP server?

Navigate to the server directory and run npm run dev for development or npm run build to build the server. The entry point is server/dist/cli.js.

Is this extension published to any extension stores?

Currently, the extension is not published to any extension store. Publishing to extension stores is on the roadmap.