Content
# 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
```bash
pnpm i
```
### Extension
```bash
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
```bash
cd server
# dev
npm run dev
# build
npm run build
```
`server/dist/cli.js` is the MCP server entry.
## Contributing
### Add a new tool
1. Add the tool schema to the `tools` array in `server/src/tools.ts`.
2. Add a extension callable handler in `extension/calls.ts`.
3. Add a tool handler in `server/src/tools.ts`. Use the `call` function to call the extension handler.
## License
AGPL-3.0-or-later
MCP Store