chrome-mcp
A Model Context Protocol server for browser automation, powered by DrissionPage.
Lets MCP clients (Claude Desktop, Claude Code, Cursor, etc.) drive a real Chromium browser: navigate, screenshot, execute JavaScript, snapshot the DOM, and capture network traffic — all through the standard MCP tool interface.
Features
- Navigation — open URLs with a configurable timeout
- Screenshots — full-page or viewport capture
- JavaScript execution — run arbitrary JS in the page context
- DOM snapshot — accessibility-tree based text snapshot for LLM consumption
- Network capture — record request/response metadata for analysis
- Workspace isolation — logical
/workspacepaths are mapped to a project-local directory
Installation
uv tool install chrome-mcp
# or
uvx chrome-mcp
# or
pip install chrome-mcp
Requires Python ≥ 3.10 and a local Chromium-based browser.
Usage
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"chrome": {
"command": "chrome-mcp"
}
}
}
Tools provided
| Tool | Description |
|---|---|
navigate |
Navigate to a URL |
screenshot |
Capture a screenshot |
execute_js |
Execute JavaScript in the page |
get_current_url |
Get the current URL |
get_page_title |
Get the page title |
close_browser |
Close the browser instance |
get_dom_snapshot |
Get a text snapshot of the DOM |
start_capture |
Start network capture |
get_captured_requests |
Retrieve captured network requests |
stop_capture |
Stop network capture and clear buffer |
License
1 maintainer
Release files for chrome-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| chrome_mcp-0.1.2.tar.gz | 26.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| chrome_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.0 kB
Release files / chrome_mcp-0.1.2.tar.gz
| Download URL | chrome_mcp-0.1.2.tar.gz |
|---|---|
| Size | 26.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a5d07819aa68c566faac6595a5d5107c8d7dbc5ad19c6af48d3018d57ab9ea1
|
|
BLAKE2b-256 checksum How to use checksums |
8fda6ef5e35c50b2695fe3b4ef7e0fa383ba6bdfeff73e44cfb1b8d7a8a9fc7b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / chrome_mcp-0.1.2-py3-none-any.whl
| Download URL | chrome_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 27.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
27dfd2ed14a28964f9641fdb3e13555941f8e0effb1e1e39a1b26d16f44db2ca
|
|
BLAKE2b-256 checksum How to use checksums |
60083106f16f84a607b90f1473aefecf4cfd67534059ef4ae0324787f8e64004
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
