@pyrokine/mcp-chrome 2.4.4 → 3.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.
Files changed (118) hide show
  1. package/README.md +495 -115
  2. package/README_zh.md +423 -128
  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 +105 -15
  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 +22 -4
  20. package/dist/core/errors.d.ts.map +1 -1
  21. package/dist/core/errors.js +90 -7
  22. package/dist/core/errors.js.map +1 -1
  23. package/dist/core/locator.d.ts +7 -0
  24. package/dist/core/locator.d.ts.map +1 -1
  25. package/dist/core/locator.js +54 -29
  26. package/dist/core/locator.js.map +1 -1
  27. package/dist/core/os-mouse.d.ts +15 -2
  28. package/dist/core/os-mouse.d.ts.map +1 -1
  29. package/dist/core/os-mouse.js +52 -8
  30. package/dist/core/os-mouse.js.map +1 -1
  31. package/dist/core/session.d.ts +39 -22
  32. package/dist/core/session.d.ts.map +1 -1
  33. package/dist/core/session.js +632 -153
  34. package/dist/core/session.js.map +1 -1
  35. package/dist/core/types.d.ts +2 -0
  36. package/dist/core/types.d.ts.map +1 -1
  37. package/dist/core/types.js.map +1 -1
  38. package/dist/core/unified-session.d.ts +105 -27
  39. package/dist/core/unified-session.d.ts.map +1 -1
  40. package/dist/core/unified-session.js +554 -138
  41. package/dist/core/unified-session.js.map +1 -1
  42. package/dist/core/utils.d.ts +5 -0
  43. package/dist/core/utils.d.ts.map +1 -1
  44. package/dist/core/utils.js +475 -54
  45. package/dist/core/utils.js.map +1 -1
  46. package/dist/extension/bridge.d.ts +49 -39
  47. package/dist/extension/bridge.d.ts.map +1 -1
  48. package/dist/extension/bridge.js +318 -131
  49. package/dist/extension/bridge.js.map +1 -1
  50. package/dist/extension/http-server.d.ts +3 -0
  51. package/dist/extension/http-server.d.ts.map +1 -1
  52. package/dist/extension/http-server.js +28 -2
  53. package/dist/extension/http-server.js.map +1 -1
  54. package/dist/index.js +7 -0
  55. package/dist/index.js.map +1 -1
  56. package/dist/tools/browse.d.ts.map +1 -1
  57. package/dist/tools/browse.js +248 -172
  58. package/dist/tools/browse.js.map +1 -1
  59. package/dist/tools/challenge.d.ts +1 -1
  60. package/dist/tools/challenge.d.ts.map +1 -1
  61. package/dist/tools/challenge.js +86 -51
  62. package/dist/tools/challenge.js.map +1 -1
  63. package/dist/tools/cookies.d.ts.map +1 -1
  64. package/dist/tools/cookies.js +5 -3
  65. package/dist/tools/cookies.js.map +1 -1
  66. package/dist/tools/diagnostics.d.ts +3 -3
  67. package/dist/tools/diagnostics.d.ts.map +1 -1
  68. package/dist/tools/diagnostics.js +13 -12
  69. package/dist/tools/diagnostics.js.map +1 -1
  70. package/dist/tools/evaluate.d.ts.map +1 -1
  71. package/dist/tools/evaluate.js +67 -26
  72. package/dist/tools/evaluate.js.map +1 -1
  73. package/dist/tools/extract.d.ts.map +1 -1
  74. package/dist/tools/extract.js +137 -197
  75. package/dist/tools/extract.js.map +1 -1
  76. package/dist/tools/input.d.ts +1 -1
  77. package/dist/tools/input.d.ts.map +1 -1
  78. package/dist/tools/input.js +445 -197
  79. package/dist/tools/input.js.map +1 -1
  80. package/dist/tools/logs.d.ts.map +1 -1
  81. package/dist/tools/logs.js +5 -5
  82. package/dist/tools/logs.js.map +1 -1
  83. package/dist/tools/manage.d.ts.map +1 -1
  84. package/dist/tools/manage.js +395 -86
  85. package/dist/tools/manage.js.map +1 -1
  86. package/dist/tools/page-context.d.ts +17 -0
  87. package/dist/tools/page-context.d.ts.map +1 -0
  88. package/dist/tools/page-context.js +103 -0
  89. package/dist/tools/page-context.js.map +1 -0
  90. package/dist/tools/png.d.ts +5 -0
  91. package/dist/tools/png.d.ts.map +1 -1
  92. package/dist/tools/png.js +84 -19
  93. package/dist/tools/png.js.map +1 -1
  94. package/dist/tools/post-condition.d.ts.map +1 -1
  95. package/dist/tools/post-condition.js +24 -7
  96. package/dist/tools/post-condition.js.map +1 -1
  97. package/dist/tools/schema.d.ts +9 -0
  98. package/dist/tools/schema.d.ts.map +1 -1
  99. package/dist/tools/schema.js +15 -0
  100. package/dist/tools/schema.js.map +1 -1
  101. package/dist/tools/target-diagnostics.d.ts +9 -1
  102. package/dist/tools/target-diagnostics.d.ts.map +1 -1
  103. package/dist/tools/target-diagnostics.js +89 -33
  104. package/dist/tools/target-diagnostics.js.map +1 -1
  105. package/dist/tools/wait.d.ts.map +1 -1
  106. package/dist/tools/wait.js +38 -32
  107. package/dist/tools/wait.js.map +1 -1
  108. package/extension/dist/assets/content.ts-loader-DUWbDHRS.js +13 -0
  109. package/extension/dist/assets/content.ts-qe6IB5DK.js +13 -0
  110. package/extension/dist/assets/{index.ts-Bqcu2qiN.js → index.ts-D7_LCUoV.js} +2477 -2201
  111. package/extension/dist/assets/page-scripts-D508WLkW.js +1378 -0
  112. package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-B-eVq48O.js} +54 -5
  113. package/extension/dist/manifest.json +4 -3
  114. package/extension/dist/service-worker-loader.js +1 -1
  115. package/extension/dist/src/popup/popup.html +11 -1
  116. package/package.json +16 -8
  117. package/scripts/start-chrome.ps1 +58 -0
  118. 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 = "连接中...";
@@ -84,15 +131,16 @@ connectBtn.addEventListener("click", async () => {
84
131
  saveTokenBtn.addEventListener("click", async () => {
85
132
  saveTokenBtn.disabled = true;
86
133
  try {
87
- await chrome.runtime.sendMessage({
134
+ const response = await chrome.runtime.sendMessage({
88
135
  type: "SET_PAIRING_TOKEN",
89
136
  token: pairingTokenInput.value
90
137
  });
138
+ if (response?.error || response?.success !== true) throw new Error(response?.error ?? "保存 token 失败");
91
139
  pairingTokenInput.value = "";
92
140
  await updateStatus();
93
141
  } catch (error) {
94
142
  console.error("Save token failed:", error);
95
- authHelp.textContent = "保存 token 失败";
143
+ authHelp.textContent = `保存 token 失败:${error instanceof Error ? error.message : String(error)}`;
96
144
  } finally {
97
145
  saveTokenBtn.disabled = false;
98
146
  }
@@ -100,14 +148,15 @@ saveTokenBtn.addEventListener("click", async () => {
100
148
  allowInsecureNoTokenInput.addEventListener("change", async () => {
101
149
  allowInsecureNoTokenInput.disabled = true;
102
150
  try {
103
- await chrome.runtime.sendMessage({
151
+ const response = await chrome.runtime.sendMessage({
104
152
  type: "SET_ALLOW_INSECURE_NO_TOKEN",
105
153
  allow: allowInsecureNoTokenInput.checked
106
154
  });
155
+ if (response?.error || response?.success !== true) throw new Error(response?.error ?? "保存无 token 连接设置失败");
107
156
  await updateStatus();
108
157
  } catch (error) {
109
158
  console.error("Save insecure mode failed:", error);
110
- authHelp.textContent = "保存无 token 连接设置失败";
159
+ authHelp.textContent = `保存无 token 连接设置失败:${error instanceof Error ? error.message : String(error)}`;
111
160
  } finally {
112
161
  allowInsecureNoTokenInput.disabled = false;
113
162
  }
@@ -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.1",
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-DUWbDHRS.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-D508WLkW.js",
59
+ "assets/content.ts-qe6IB5DK.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-D7_LCUoV.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-B-eVq48O.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.1",
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,extension/src}/**/*.ts\" \"{test,extension/test}/**/*.js\" \"extension/vite*.ts\"",
16
+ "lint:fix": "npm run lint -- --fix",
17
+ "format": "prettier -w --prose-wrap=always src test \"extension/{src/**,test/**,vite*.ts}\" \"*.md\"",
18
+ "format:check": "prettier -c --prose-wrap=always src test \"extension/{src/**,test/**,vite*.ts}\" \"*.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",
@@ -28,8 +29,13 @@
28
29
  ],
29
30
  "author": "Pyrokine",
30
31
  "license": "MIT",
32
+ "repository": {
33
+ "type": "git",
34
+ "url": "git+https://github.com/Pyrokine/claude-tools.git",
35
+ "directory": "mcp-chrome"
36
+ },
31
37
  "dependencies": {
32
- "@modelcontextprotocol/sdk": "^1.30.0",
38
+ "@modelcontextprotocol/sdk": "^1.32.1",
33
39
  "ws": "^8.21.1",
34
40
  "zod": "^4.4.3"
35
41
  },
@@ -52,8 +58,10 @@
52
58
  "files": [
53
59
  "dist",
54
60
  "extension/dist",
61
+ "scripts/start-chrome.ps1",
55
62
  "README.md",
56
63
  "README_zh.md",
57
64
  "LICENSE"
58
- ]
65
+ ],
66
+ "gitHead": "8ecb805b68619692cf9b1a72eb0bc58e5e3f8b26"
59
67
  }
@@ -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
- })()