# Browser CDP MCP Server
A minimal MCP (Model Context Protocol) server that provides direct access to the Chrome DevTools Protocol (CDP) for maximum flexibility browser control.
## Features
- **Raw CDP Access**: Call any Chrome DevTools Protocol method directly via `cdp_send`
- **Screenshot Capture**: Take screenshots in PNG or JPEG format
- **URL Retrieval**: Get the current page URL
- **Browser Management**: Launch and close browser instances
## Installation
```bash
npm install
```
## Usage
```bash
npm start
```
The server communicates over stdio using the MCP protocol.
## Tools
### `cdp_send`
Execute any CDP method. Reference: https://chromedevtools.github.io/devtools-protocol/
**Parameters:**
- `method` (string): CDP method name (e.g., `Page.navigate`, `DOM.getDocument`, `Runtime.evaluate`)
- `params` (object, optional): Parameters for the CDP method
**Example:**
```json
{
"method": "Page.navigate",
"params": { "url": "https://example.com" }
}
```
### `screenshot`
Capture a screenshot of the current page.
**Parameters:**
- `format` (string, optional): `"png"` or `"jpeg"` (default: `"png"`)
- `fullPage` (boolean, optional): Capture full scrollable page (default: `false`)
### `get_url`
Returns the current page URL.
### `close_browser`
Closes the browser instance and cleans up resources.
## MCP Configuration
Add to your MCP client configuration:
```bash
claude mcp add-json browser '{
"type": "stdio",
"command": "node",
"args": ["path/to/browser-tool/server.js"]
}' --scope user
```
## Skill Integration
Add the browser skill to claude:
```bash
cp .path/to/browser-tool/.claude/skills/browser.md ~/.claude/skills/browser.md
```
## Dependencies
- `@modelcontextprotocol/sdk` - MCP SDK for server implementation
- `playwright` - Browser automation
- `zod` - Schema validation
## License
MIT
