chromium-devtools-mcp 0.0.0-stage → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +43 -2
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +2 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/package.json +41 -4
package/README.md
CHANGED
|
@@ -1,3 +1,44 @@
|
|
|
1
|
-
#
|
|
1
|
+
# chromium-devtools-mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
MCP server that lets AI agents drive your real Chromium browser through the DevTools Protocol.
|
|
4
|
+
|
|
5
|
+
Status: design phase. Nothing is published yet.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- Works with the browser you already use, including your profile, bookmarks and logins, or with a separate persistent managed profile. Switchable in config.
|
|
10
|
+
- Tabs open in the background. The window is brought to the front only on an explicit request.
|
|
11
|
+
- Headless and interactive modes.
|
|
12
|
+
- One-command install into your MCP client.
|
|
13
|
+
- Safety controls: read-only mode, domain allowlist, confirmation of dangerous actions.
|
|
14
|
+
|
|
15
|
+
## Install (planned)
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
npx chromium-devtools-mcp install --client claude-code
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Clients: Claude Code, Cherry Studio, Cursor, Codex.
|
|
22
|
+
|
|
23
|
+
## Supported
|
|
24
|
+
|
|
25
|
+
- Browsers: Chrome, Arc.
|
|
26
|
+
- OS: macOS, Linux, Windows.
|
|
27
|
+
- Transport: stdio.
|
|
28
|
+
- Node.js 22 or newer.
|
|
29
|
+
|
|
30
|
+
## Roadmap
|
|
31
|
+
|
|
32
|
+
1. Repository, npm name and CI.
|
|
33
|
+
2. Core: config, CDP client, browser discovery, managed and attach modes, daemon.
|
|
34
|
+
3. Tools: tabs, navigation, DOM, input, network, emulation, storage, dialogs, network mocking.
|
|
35
|
+
4. Safety controls.
|
|
36
|
+
5. Client installer.
|
|
37
|
+
6. First release.
|
|
38
|
+
7. Later: performance traces and Core Web Vitals, Lighthouse, heap snapshots.
|
|
39
|
+
|
|
40
|
+
Detailed steps are in [docs/PLAN.md](docs/PLAN.md).
|
|
41
|
+
|
|
42
|
+
## License
|
|
43
|
+
|
|
44
|
+
MIT
|
package/dist/cli.d.ts
ADDED
package/dist/cli.js
ADDED
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
package/package.json
CHANGED
|
@@ -1,6 +1,43 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chromium-devtools-mcp",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"description": "MCP server that lets AI agents drive your Chromium browser through the DevTools Protocol",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "Milana Kustinskaya <me@bramfoxie.com>",
|
|
7
|
+
"type": "module",
|
|
8
|
+
"bin": {
|
|
9
|
+
"chromium-devtools-mcp": "dist/cli.js"
|
|
10
|
+
},
|
|
11
|
+
"main": "dist/index.js",
|
|
12
|
+
"files": [
|
|
13
|
+
"dist"
|
|
14
|
+
],
|
|
15
|
+
"engines": {
|
|
16
|
+
"node": ">=22"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"mcp",
|
|
20
|
+
"chrome",
|
|
21
|
+
"chromium",
|
|
22
|
+
"arc",
|
|
23
|
+
"devtools",
|
|
24
|
+
"cdp"
|
|
25
|
+
],
|
|
26
|
+
"scripts": {
|
|
27
|
+
"build": "tsc -p tsconfig.build.json",
|
|
28
|
+
"typecheck": "tsc --noEmit",
|
|
29
|
+
"lint": "eslint . && prettier --check .",
|
|
30
|
+
"format": "prettier --write .",
|
|
31
|
+
"test": "vitest run --passWithNoTests",
|
|
32
|
+
"prepare": "git config core.hooksPath .githooks || true",
|
|
33
|
+
"prepublishOnly": "npm run build"
|
|
34
|
+
},
|
|
35
|
+
"devDependencies": {
|
|
36
|
+
"@types/node": "^26.6.6",
|
|
37
|
+
"eslint": "^10.14.0",
|
|
38
|
+
"prettier": "^3.9.10",
|
|
39
|
+
"typescript": "^6.0.3",
|
|
40
|
+
"typescript-eslint": "^8.72.1",
|
|
41
|
+
"vitest": "^5.0.5"
|
|
42
|
+
}
|
|
43
|
+
}
|