browser-mcp
@djyde
A browser extension and MCP server that allows you to interact with the browser you are using.
Overview
What is browser-mcp?
browser-mcp is an MCP server that works with a companion browser extension. It lets you interact with the browser you are currently using through a set of tools, such as getting the page content as Markdown, applying CSS, and searching history. It is built for developers and users who want to control their browser programmatically via MCP clients.
How to use browser-mcp?
Configure the server in your MCP client’s mcpServers object with the command npx and the argument @djyde/mcp-browser@latest. Once connected, the available tools will be ready to call through the MCP protocol.
Key features of browser-mcp
- Get Markdown of the current browser page.
- Append custom CSS styles to a page.
- Search browser history.
- Run as an MCP server via npx.
- Buildable from source with pnpm.
Use cases of browser-mcp
- Summarise the content of the current page.
- Change the current page’s appearance (e.g., dark mode).
- Quickly find a previously visited URL by searching history.
FAQ from browser-mcp
How do I connect browser-mcp to my MCP client?
Add the following configuration to your client’s mcpServers object: {"command": "npx", "args": ["@djyde/mcp-browser@latest"]}.
What tools does browser-mcp provide?
The tools include get_current_page_markdown, append_style, and history_search. A full list is in server/src/tools.ts.
How can I build the extension from source?
Clone the repo, run pnpm i, then cd extension and build for Chrome, Edge, or Firefox using npm run build, npm run build:edge, or npm run build:firefox. The output appears in extension/.output.
Is the browser extension published to extension stores?
Not yet—it is on the roadmap to publish to extension stores.
What license is browser-mcp under?
It is licensed under the AGPL-3.0-or-later license.
