@pyrokine/mcp-chrome 2.4.4 → 3.0.0

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.
Files changed (116) hide show
  1. package/README.md +401 -102
  2. package/README_zh.md +319 -79
  3. package/dist/anti-detection/injection.js +3 -3
  4. package/dist/cdp/client.d.ts +1 -1
  5. package/dist/cdp/client.d.ts.map +1 -1
  6. package/dist/cdp/client.js +18 -7
  7. package/dist/cdp/client.js.map +1 -1
  8. package/dist/cdp/launcher.d.ts +2 -3
  9. package/dist/cdp/launcher.d.ts.map +1 -1
  10. package/dist/cdp/launcher.js +84 -24
  11. package/dist/cdp/launcher.js.map +1 -1
  12. package/dist/core/auto-wait.d.ts +3 -3
  13. package/dist/core/auto-wait.d.ts.map +1 -1
  14. package/dist/core/auto-wait.js +45 -20
  15. package/dist/core/auto-wait.js.map +1 -1
  16. package/dist/core/browser-driver.d.ts +101 -12
  17. package/dist/core/browser-driver.d.ts.map +1 -1
  18. package/dist/core/browser-driver.js.map +1 -1
  19. package/dist/core/errors.d.ts +16 -0
  20. package/dist/core/errors.d.ts.map +1 -1
  21. package/dist/core/errors.js +77 -0
  22. package/dist/core/errors.js.map +1 -1
  23. package/dist/core/locator.d.ts.map +1 -1
  24. package/dist/core/locator.js +6 -4
  25. package/dist/core/locator.js.map +1 -1
  26. package/dist/core/os-mouse.d.ts +15 -2
  27. package/dist/core/os-mouse.d.ts.map +1 -1
  28. package/dist/core/os-mouse.js +52 -8
  29. package/dist/core/os-mouse.js.map +1 -1
  30. package/dist/core/session.d.ts +34 -19
  31. package/dist/core/session.d.ts.map +1 -1
  32. package/dist/core/session.js +574 -130
  33. package/dist/core/session.js.map +1 -1
  34. package/dist/core/types.d.ts +2 -0
  35. package/dist/core/types.d.ts.map +1 -1
  36. package/dist/core/types.js.map +1 -1
  37. package/dist/core/unified-session.d.ts +95 -20
  38. package/dist/core/unified-session.d.ts.map +1 -1
  39. package/dist/core/unified-session.js +489 -117
  40. package/dist/core/unified-session.js.map +1 -1
  41. package/dist/core/utils.d.ts +5 -0
  42. package/dist/core/utils.d.ts.map +1 -1
  43. package/dist/core/utils.js +475 -54
  44. package/dist/core/utils.js.map +1 -1
  45. package/dist/extension/bridge.d.ts +46 -36
  46. package/dist/extension/bridge.d.ts.map +1 -1
  47. package/dist/extension/bridge.js +269 -112
  48. package/dist/extension/bridge.js.map +1 -1
  49. package/dist/extension/http-server.d.ts +3 -0
  50. package/dist/extension/http-server.d.ts.map +1 -1
  51. package/dist/extension/http-server.js +19 -2
  52. package/dist/extension/http-server.js.map +1 -1
  53. package/dist/index.js +7 -0
  54. package/dist/index.js.map +1 -1
  55. package/dist/tools/browse.d.ts.map +1 -1
  56. package/dist/tools/browse.js +241 -171
  57. package/dist/tools/browse.js.map +1 -1
  58. package/dist/tools/challenge.d.ts +1 -1
  59. package/dist/tools/challenge.d.ts.map +1 -1
  60. package/dist/tools/challenge.js +75 -37
  61. package/dist/tools/challenge.js.map +1 -1
  62. package/dist/tools/cookies.d.ts.map +1 -1
  63. package/dist/tools/cookies.js +5 -3
  64. package/dist/tools/cookies.js.map +1 -1
  65. package/dist/tools/diagnostics.d.ts +3 -3
  66. package/dist/tools/diagnostics.d.ts.map +1 -1
  67. package/dist/tools/diagnostics.js +13 -12
  68. package/dist/tools/diagnostics.js.map +1 -1
  69. package/dist/tools/evaluate.d.ts.map +1 -1
  70. package/dist/tools/evaluate.js +57 -26
  71. package/dist/tools/evaluate.js.map +1 -1
  72. package/dist/tools/extract.d.ts.map +1 -1
  73. package/dist/tools/extract.js +107 -175
  74. package/dist/tools/extract.js.map +1 -1
  75. package/dist/tools/input.d.ts +1 -1
  76. package/dist/tools/input.d.ts.map +1 -1
  77. package/dist/tools/input.js +380 -158
  78. package/dist/tools/input.js.map +1 -1
  79. package/dist/tools/logs.d.ts.map +1 -1
  80. package/dist/tools/logs.js +5 -5
  81. package/dist/tools/logs.js.map +1 -1
  82. package/dist/tools/manage.d.ts.map +1 -1
  83. package/dist/tools/manage.js +380 -57
  84. package/dist/tools/manage.js.map +1 -1
  85. package/dist/tools/page-context.d.ts +17 -0
  86. package/dist/tools/page-context.d.ts.map +1 -0
  87. package/dist/tools/page-context.js +103 -0
  88. package/dist/tools/page-context.js.map +1 -0
  89. package/dist/tools/png.d.ts +5 -0
  90. package/dist/tools/png.d.ts.map +1 -1
  91. package/dist/tools/png.js +84 -19
  92. package/dist/tools/png.js.map +1 -1
  93. package/dist/tools/post-condition.d.ts.map +1 -1
  94. package/dist/tools/post-condition.js +5 -2
  95. package/dist/tools/post-condition.js.map +1 -1
  96. package/dist/tools/schema.d.ts +9 -0
  97. package/dist/tools/schema.d.ts.map +1 -1
  98. package/dist/tools/schema.js +15 -0
  99. package/dist/tools/schema.js.map +1 -1
  100. package/dist/tools/target-diagnostics.d.ts.map +1 -1
  101. package/dist/tools/target-diagnostics.js +32 -19
  102. package/dist/tools/target-diagnostics.js.map +1 -1
  103. package/dist/tools/wait.d.ts.map +1 -1
  104. package/dist/tools/wait.js +19 -25
  105. package/dist/tools/wait.js.map +1 -1
  106. package/extension/dist/assets/content.ts-C4imZ6A9.js +13 -0
  107. package/extension/dist/assets/content.ts-loader-CnJuCGhl.js +13 -0
  108. package/extension/dist/assets/{index.ts-Bqcu2qiN.js → index.ts-GeHNZBml.js} +2040 -2111
  109. package/extension/dist/assets/page-scripts-CMIY1zhd.js +1379 -0
  110. package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-CgtWL6Py.js} +48 -1
  111. package/extension/dist/manifest.json +4 -3
  112. package/extension/dist/service-worker-loader.js +1 -1
  113. package/extension/dist/src/popup/popup.html +11 -1
  114. package/package.json +9 -7
  115. package/scripts/start-chrome.ps1 +58 -0
  116. package/extension/dist/assets/content.ts-Cj_iiU2s.js +0 -25
@@ -41,9 +41,32 @@ var pairingTokenInput = document.getElementById("pairingTokenInput");
41
41
  var saveTokenBtn = document.getElementById("saveTokenBtn");
42
42
  var allowInsecureNoTokenInput = document.getElementById("allowInsecureNoTokenInput");
43
43
  var authHelp = document.getElementById("authHelp");
44
+ var readServer = document.getElementById("readServer");
45
+ var readAccess = document.getElementById("readAccess");
46
+ var readHelp = document.getElementById("readHelp");
47
+ var activeTabId;
44
48
  async function updateStatus() {
45
49
  try {
46
- const response = await chrome.runtime.sendMessage({ type: "GET_STATUS" });
50
+ const [activeTab] = await chrome.tabs.query({
51
+ active: true,
52
+ lastFocusedWindow: true
53
+ });
54
+ activeTabId = activeTab?.id;
55
+ const response = await chrome.runtime.sendMessage({
56
+ type: "GET_STATUS",
57
+ tabId: activeTabId
58
+ });
59
+ const selectedPort = readServer.value;
60
+ readServer.replaceChildren(...(response.ports ?? []).map((port) => {
61
+ const option = document.createElement("option");
62
+ option.value = String(port);
63
+ option.textContent = `MCP Server ${port}`;
64
+ return option;
65
+ }));
66
+ if ((response.ports ?? []).some((port) => String(port) === selectedPort)) readServer.value = selectedPort;
67
+ readAccess.checked = (response.readAccess ?? []).find((item) => String(item.port) === readServer.value)?.allowed === true;
68
+ readAccess.disabled = !activeTabId || !readServer.value || response.managed === true;
69
+ readHelp.textContent = response.managed ? `页面 ${activeTabId} 已受控,可读取、输入、执行脚本和截图,无需普通只读授权` : activeTabId ? `页面 ${activeTabId} 未受控,此授权仅允许文字、HTML 和元信息读取;完整操作需显式 adoptPage` : "当前窗口没有可授权的活动页面";
47
70
  if (response.connected) {
48
71
  const ports = response.ports ?? [];
49
72
  statusIndicator.className = "status-indicator connected";
@@ -66,6 +89,30 @@ async function updateStatus() {
66
89
  statusText.textContent = "未连接";
67
90
  }
68
91
  }
92
+ readServer.addEventListener("change", () => {
93
+ updateStatus();
94
+ });
95
+ readAccess.addEventListener("change", async () => {
96
+ const tabId = activeTabId;
97
+ const port = Number(readServer.value);
98
+ const allow = readAccess.checked;
99
+ readAccess.disabled = true;
100
+ try {
101
+ if (tabId === void 0 || !Number.isSafeInteger(port)) throw new Error("未选择活动页面或 MCP Server");
102
+ const result = await chrome.runtime.sendMessage({
103
+ type: "SET_READ_ACCESS",
104
+ port,
105
+ tabId,
106
+ allow
107
+ });
108
+ if (!result?.success) throw new Error(result?.error ?? "只读授权失败");
109
+ await updateStatus();
110
+ } catch (error) {
111
+ readAccess.checked = !allow;
112
+ readHelp.textContent = error instanceof Error ? error.message : String(error);
113
+ readAccess.disabled = false;
114
+ }
115
+ });
69
116
  connectBtn.addEventListener("click", async () => {
70
117
  connectBtn.disabled = true;
71
118
  statusText.textContent = "连接中...";
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "manifest_version": 3,
3
3
  "name": "MCP Chrome",
4
- "version": "2.4.4",
4
+ "version": "3.0.0",
5
5
  "description": "Browser automation for Claude Code via MCP protocol",
6
6
  "permissions": [
7
7
  "alarms",
@@ -38,7 +38,7 @@
38
38
  "content_scripts": [
39
39
  {
40
40
  "js": [
41
- "assets/content.ts-Cj_iiU2s.js"
41
+ "assets/content.ts-loader-CnJuCGhl.js"
42
42
  ],
43
43
  "matches": [
44
44
  "<all_urls>"
@@ -55,7 +55,8 @@
55
55
  "<all_urls>"
56
56
  ],
57
57
  "resources": [
58
- "assets/content.ts-Cj_iiU2s.js"
58
+ "assets/page-scripts-CMIY1zhd.js",
59
+ "assets/content.ts-C4imZ6A9.js"
59
60
  ],
60
61
  "use_dynamic_url": false
61
62
  }
@@ -1 +1 @@
1
- import './assets/index.ts-Bqcu2qiN.js';
1
+ import './assets/index.ts-GeHNZBml.js';
@@ -4,7 +4,7 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta content="width=device-width, initial-scale=1.0" name="viewport" />
6
6
  <title>MCP Chrome</title>
7
- <script type="module" crossorigin src="/assets/popup.html-B81xccfq.js"></script>
7
+ <script type="module" crossorigin src="/assets/popup.html-CgtWL6Py.js"></script>
8
8
  <link rel="stylesheet" crossorigin href="/assets/popup-BwuBB9Cz.css">
9
9
  </head>
10
10
  <body>
@@ -40,6 +40,16 @@
40
40
  <p class="auth-help" id="authHelp">默认自动连接本地 MCP Server,可用 pairing token 加固</p>
41
41
  </div>
42
42
 
43
+ <div class="auth-section">
44
+ <label class="auth-label" for="readServer">当前页面只读授权</label>
45
+ <select class="auth-input" id="readServer" aria-label="选择 MCP Server"></select>
46
+ <label class="auth-checkbox">
47
+ <input id="readAccess" type="checkbox" disabled />
48
+ 允许所选 MCP Server 读取当前页面
49
+ </label>
50
+ <p class="auth-help" id="readHelp">只允许读取页面文字、HTML 和元信息,不允许截图、脚本或写操作</p>
51
+ </div>
52
+
43
53
  <div class="info-section">
44
54
  <p class="info-text">通过 WebSocket 与 MCP Server 通信</p>
45
55
  <p class="info-text">服务端口范围:19222-19299</p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pyrokine/mcp-chrome",
3
- "version": "2.4.4",
3
+ "version": "3.0.0",
4
4
  "description": "Chrome browser automation MCP Server using Chrome DevTools Protocol",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",
@@ -12,11 +12,12 @@
12
12
  "dev": "node node_modules/typescript7/bin/tsc -w",
13
13
  "prepare": "npm run build",
14
14
  "prepack": "npm run build && npm run build:extension",
15
- "lint": "eslint \"src/**/*.ts\" \"extension/src/**/*.ts\" \"test/**/*.js\"",
16
- "lint:fix": "eslint \"src/**/*.ts\" \"extension/src/**/*.ts\" \"test/**/*.js\" --fix",
17
- "format": "prettier -w --prose-wrap=always src extension/src test README.md README_zh.md TESTING.md",
18
- "format:check": "prettier -c --prose-wrap=always src extension/src test README.md README_zh.md TESTING.md",
19
- "test": "npm run build && node --test test/ch-regressions.test.js"
15
+ "lint": "eslint \"src/**/*.ts\" \"extension/src/**/*.ts\" \"extension/test/**/*.js\" \"extension/vite*.ts\" \"test/**/*.js\"",
16
+ "lint:fix": "eslint \"src/**/*.ts\" \"extension/src/**/*.ts\" \"extension/test/**/*.js\" \"extension/vite*.ts\" \"test/**/*.js\" --fix",
17
+ "format": "prettier -w --prose-wrap=always src extension/src extension/test extension/vite*.ts test README.md README_zh.md TESTING.md",
18
+ "format:check": "prettier -c --prose-wrap=always src extension/src extension/test extension/vite*.ts test README.md README_zh.md TESTING.md",
19
+ "test": "npm run build && node --test test/*.test.js",
20
+ "test:extension": "npm --prefix extension test"
20
21
  },
21
22
  "keywords": [
22
23
  "mcp",
@@ -29,7 +30,7 @@
29
30
  "author": "Pyrokine",
30
31
  "license": "MIT",
31
32
  "dependencies": {
32
- "@modelcontextprotocol/sdk": "^1.30.0",
33
+ "@modelcontextprotocol/sdk": "^1.32.1",
33
34
  "ws": "^8.21.1",
34
35
  "zod": "^4.4.3"
35
36
  },
@@ -52,6 +53,7 @@
52
53
  "files": [
53
54
  "dist",
54
55
  "extension/dist",
56
+ "scripts/start-chrome.ps1",
55
57
  "README.md",
56
58
  "README_zh.md",
57
59
  "LICENSE"
@@ -0,0 +1,58 @@
1
+ param(
2
+ [ValidateRange(1, 65535)]
3
+ [int]$Port = 9222,
4
+ [string]$ExecutablePath,
5
+ [string]$ProfileDir = (Join-Path $HOME '.mcp-chrome\profile')
6
+ )
7
+
8
+ $ErrorActionPreference = 'Stop'
9
+ if (-not $ExecutablePath) {
10
+ $candidates = [System.Collections.Generic.List[string]]::new()
11
+ foreach ($hive in @('HKCU:', 'HKLM:')) {
12
+ foreach ($name in @('chrome.exe', 'chromium.exe')) {
13
+ $key = "$hive\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\$name"
14
+ foreach ($view in @('', '\WOW6432Node')) {
15
+ $candidateKey = $key.Replace('\Microsoft\', "$view\Microsoft\")
16
+ if (Test-Path -LiteralPath $candidateKey) {
17
+ $value = (Get-Item -LiteralPath $candidateKey).GetValue('')
18
+ if ($value) { $candidates.Add([Environment]::ExpandEnvironmentVariables($value)) }
19
+ }
20
+ }
21
+ }
22
+ }
23
+ foreach ($folder in ($env:PATH -split ';')) {
24
+ if ($folder) {
25
+ foreach ($name in @('chrome.exe', 'chromium.exe')) {
26
+ $candidates.Add((Join-Path $folder $name))
27
+ }
28
+ }
29
+ }
30
+ $channels = @(
31
+ 'Google\Chrome\Application\chrome.exe',
32
+ 'Google\Chrome Beta\Application\chrome.exe',
33
+ 'Google\Chrome Dev\Application\chrome.exe',
34
+ 'Google\Chrome SxS\Application\chrome.exe',
35
+ 'Chromium\Application\chrome.exe',
36
+ 'Google\Chrome for Testing\chrome-win64\chrome.exe',
37
+ 'Google\Chrome for Testing\chrome-win32\chrome.exe'
38
+ )
39
+ foreach ($root in @($env:ProgramFiles, ${env:ProgramFiles(x86)}, $env:LOCALAPPDATA)) {
40
+ if ($root) {
41
+ foreach ($channel in $channels) { $candidates.Add((Join-Path $root $channel)) }
42
+ }
43
+ }
44
+ foreach ($root in @($env:MCP_CHROME_PORTABLE_DIR, (Join-Path $HOME '.mcp-chrome\portable'))) {
45
+ if ($root) {
46
+ foreach ($suffix in @('chrome.exe', 'chrome-win64\chrome.exe', 'chrome-win32\chrome.exe')) {
47
+ $candidates.Add((Join-Path $root $suffix))
48
+ }
49
+ }
50
+ }
51
+ $ExecutablePath = $candidates | Where-Object { Test-Path -LiteralPath $_ -PathType Leaf } | Select-Object -First 1
52
+ }
53
+ if (-not $ExecutablePath -or -not (Test-Path -LiteralPath $ExecutablePath -PathType Leaf)) {
54
+ throw 'Chrome/Chromium not found; pass -ExecutablePath or install Chrome'
55
+ }
56
+ New-Item -ItemType Directory -Force -Path $ProfileDir | Out-Null
57
+ & $ExecutablePath "--remote-debugging-port=$Port" '--remote-debugging-address=127.0.0.1' "--user-data-dir=$ProfileDir" '--no-first-run' '--no-default-browser-check' 'about:blank'
58
+ if ($LASTEXITCODE -ne 0) { throw "Chrome exited with code $LASTEXITCODE" }
@@ -1,25 +0,0 @@
1
- (function(){//#region src/content/content.ts
2
- window.__mcpElementMap = window.__mcpElementMap || {};
3
- window.__mcpRefCounter = window.__mcpRefCounter || 0;
4
- window.addEventListener("message", (event) => {
5
- const data = event.data;
6
- if (event.source !== window.parent || data?.type !== "mcp-frame-probe" || typeof data.token !== "string" || data.token.length > 100 || !Number.isInteger(data.index) || (data.index ?? -1) < 0) return;
7
- const source = event.source;
8
- chrome.runtime.sendMessage({
9
- type: "MCP_FRAME_PROBE",
10
- token: data.token,
11
- index: data.index
12
- }).then((response) => {
13
- if (!response?.accepted) return;
14
- source.postMessage({
15
- type: "mcp-frame-probe-ack",
16
- token: data.token,
17
- index: data.index
18
- }, "*");
19
- }).catch((error) => {
20
- console.warn("[MCP] iframe identity probe failed:", error instanceof Error ? error.message : String(error));
21
- });
22
- });
23
- console.log("[MCP] Content script loaded");
24
- //#endregion
25
- })()