browser-mcp
A browser extension and MCP server that allows you to interact with the browser you are using.
Usage
{
"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
pnpm i
Extension
cd 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
cd 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