browser-mcp
A browser extension and MCP server that allows you to interact with the browser you are using.
Usage
json{ "mcpServers": { "playwright": { "command": "npx", "args": [ "@djyde/mcp-browser@latest" ] } } }
Tools
All available tools are listed in server/src/tools.ts.
get_current_page_markdown
Get the markdown from current browser browsing page.
example:
Summarize the current page.
append_style
Append a css style to the current browser browsing page.
example:
Change the current page to dark mode.
history_search
Search the browser history.
example:
Search the browser history for "github".
Roadmap
- Publish the extension to extension store.
- Write documentation.
- Add more tools.
Build
bashpnpm i
Extension
bashcd extension # chrome npm run build # edge npm run build:edge # firefox npm run build:firefox
After building, the extension will be in the extension/.output directory.
Server
bashcd server # dev npm run dev # build npm run build
server/dist/cli.js is the MCP server entry.
Contributing
Add a new tool
- Add the tool schema to the
toolsarray inserver/src/tools.ts. - Add a extension callable handler in
extension/calls.ts. - Add a tool handler in
server/src/tools.ts. Use thecallfunction to call the extension handler.
License
AGPL-3.0-or-later



