cloakbrowser-mcp 1.2.5 → 1.2.7

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 (3) hide show
  1. package/README.md +20 -4
  2. package/package.json +5 -3
  3. package/server.json +49 -5
package/README.md CHANGED
@@ -15,6 +15,7 @@
15
15
  [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-published-2E8555)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.swimmwatch%2Fcloakbrowser-mcp)
16
16
  [![cloakbrowser-mcp MCP server](https://glama.ai/mcp/servers/swimmwatch/cloakbrowser-mcp/badges/score.svg)](https://glama.ai/mcp/servers/swimmwatch/cloakbrowser-mcp)
17
17
  [![npm](https://img.shields.io/npm/v/cloakbrowser-mcp.svg?logo=npm)](https://www.npmjs.com/package/cloakbrowser-mcp)
18
+ [![Docker Hub pulls](https://img.shields.io/docker/pulls/swimmwatch/cloakbrowser-mcp?logo=docker&label=Docker%20Hub)](https://hub.docker.com/r/swimmwatch/cloakbrowser-mcp)
18
19
  [![Node.js >=20](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
19
20
  [![MCP Server](https://img.shields.io/badge/MCP-server-000000)](https://modelcontextprotocol.io/)
20
21
  [![Docker](https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white)](docs/docker.md)
@@ -35,6 +36,8 @@ The server is intentionally thin:
35
36
 
36
37
  | cloakbrowser-mcp | @playwright/mcp | Playwright MCP Docker base | CloakBrowser | Node.js | Transport | Platform | Parity |
37
38
  | --- | --- | --- | --- | --- | --- | --- | --- |
39
+ | `1.2.7` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio, Streamable HTTP | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
40
+ | `1.2.6` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio, Streamable HTTP | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
38
41
  | `1.2.5` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio, Streamable HTTP | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
39
42
  | `1.2.3` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio, Streamable HTTP | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
40
43
  | `1.2.2` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio, Streamable HTTP | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
@@ -47,6 +50,18 @@ The server is intentionally thin:
47
50
 
48
51
  See [Version Compatibility](docs/version-compatibility.md) for the maintained compatibility table.
49
52
 
53
+ ## Registry visibility
54
+
55
+ `cloakbrowser-mcp` publishes `server.json` to the official [MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.swimmwatch%2Fcloakbrowser-mcp). GitHub's [`github.com/mcp`](https://github.com/mcp) registry is a separate curated discovery surface, so an official MCP Registry release may not appear there immediately.
56
+
57
+ Verify the current official registry entry and GitHub MCP visibility probe with:
58
+
59
+ ```bash
60
+ npm run registry:check
61
+ ```
62
+
63
+ Use `npm run registry:check:strict` only when GitHub MCP listing visibility should be treated as a required release gate.
64
+
50
65
  ## Run from npm
51
66
 
52
67
  ```bash
@@ -62,18 +77,19 @@ For the complete generated CLI flag reference, see the published [CLI Reference]
62
77
  ## Run from Docker
63
78
 
64
79
  ```bash
65
- docker pull ghcr.io/swimmwatch/cloakbrowser-mcp:latest
80
+ docker pull swimmwatch/cloakbrowser-mcp:latest
66
81
  docker run --rm --init -i \
67
82
  -v "$PWD/artifacts:/data" \
68
- ghcr.io/swimmwatch/cloakbrowser-mcp:latest
83
+ swimmwatch/cloakbrowser-mcp:latest
69
84
 
70
85
  docker run --rm --init -p 127.0.0.1:3000:3000 \
71
86
  -v "$PWD/artifacts:/data" \
72
- ghcr.io/swimmwatch/cloakbrowser-mcp:latest \
87
+ swimmwatch/cloakbrowser-mcp:latest \
73
88
  --transport streamable-http --http-host 0.0.0.0 --http-port 3000
74
89
  ```
75
90
 
76
91
  The Docker image is based on the pinned official Playwright MCP image, installs the bridge under `/opt/cloakbrowser-mcp`, and writes artifacts to `/data` by default.
92
+ The same tags are also published to `ghcr.io/swimmwatch/cloakbrowser-mcp`.
77
93
 
78
94
  ## MCP client configuration
79
95
 
@@ -108,7 +124,7 @@ The Docker image is based on the pinned official Playwright MCP image, installs
108
124
  "-i",
109
125
  "-v",
110
126
  "/tmp/cloakbrowser-artifacts:/data",
111
- "ghcr.io/swimmwatch/cloakbrowser-mcp:latest"
127
+ "swimmwatch/cloakbrowser-mcp:latest"
112
128
  ]
113
129
  }
114
130
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "cloakbrowser-mcp",
3
- "version": "1.2.5",
4
- "description": "Playwright MCP bridge that runs upstream browser tools with CloakBrowser.",
3
+ "version": "1.2.7",
4
+ "description": "Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.",
5
5
  "mcpName": "io.github.swimmwatch/cloakbrowser-mcp",
6
6
  "type": "module",
7
7
  "packageManager": "npm@10.9.2",
@@ -50,6 +50,8 @@
50
50
  "docs:seo:validate": "node scripts/validate-docs-seo.mjs",
51
51
  "version:apply": "node scripts/apply-release-version.mjs",
52
52
  "server:validate": "node scripts/validate-server-json.mjs",
53
+ "registry:check": "node scripts/check-github-mcp-registry.mjs",
54
+ "registry:check:strict": "node scripts/check-github-mcp-registry.mjs --strict",
53
55
  "audit:prod": "npm audit --omit=dev --audit-level=high",
54
56
  "package:verify": "npm run build && npm run server:validate && node scripts/verify-npm-package.mjs",
55
57
  "docker:build": "docker buildx build --load -t cloakbrowser-mcp:dev --build-arg RELEASE_VERSION=$npm_package_version --build-arg RELEASE_VERSION_TAG=v$npm_package_version .",
@@ -88,7 +90,7 @@
88
90
  "cloakbrowser",
89
91
  "browser-automation",
90
92
  "playwright",
91
- "stealth",
93
+ "chromium",
92
94
  "ai-agent"
93
95
  ],
94
96
  "repository": {
package/server.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.swimmwatch/cloakbrowser-mcp",
4
4
  "title": "CloakBrowser MCP",
5
- "description": "Playwright MCP bridge that runs upstream browser tools with the CloakBrowser Chromium binary.",
6
- "version": "1.2.5",
5
+ "description": "Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.",
6
+ "version": "1.2.7",
7
7
  "websiteUrl": "https://swimmwatch.github.io/cloakbrowser-mcp/",
8
8
  "repository": {
9
9
  "url": "https://github.com/swimmwatch/cloakbrowser-mcp",
@@ -21,7 +21,7 @@
21
21
  "registryType": "npm",
22
22
  "registryBaseUrl": "https://registry.npmjs.org",
23
23
  "identifier": "cloakbrowser-mcp",
24
- "version": "1.2.5",
24
+ "version": "1.2.7",
25
25
  "transport": {
26
26
  "type": "stdio"
27
27
  },
@@ -67,7 +67,7 @@
67
67
  "registryType": "npm",
68
68
  "registryBaseUrl": "https://registry.npmjs.org",
69
69
  "identifier": "cloakbrowser-mcp",
70
- "version": "1.2.5",
70
+ "version": "1.2.7",
71
71
  "packageArguments": [
72
72
  {
73
73
  "type": "named",
@@ -161,7 +161,51 @@
161
161
  },
162
162
  {
163
163
  "registryType": "oci",
164
- "identifier": "ghcr.io/swimmwatch/cloakbrowser-mcp:1.2.5",
164
+ "identifier": "ghcr.io/swimmwatch/cloakbrowser-mcp:1.2.7",
165
+ "transport": {
166
+ "type": "stdio"
167
+ },
168
+ "environmentVariables": [
169
+ {
170
+ "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
171
+ "description": "Bridge browser engine: cloak or playwright.",
172
+ "format": "string",
173
+ "default": "cloak"
174
+ },
175
+ {
176
+ "name": "PLAYWRIGHT_MCP_HEADLESS",
177
+ "description": "Run the browser in headless mode.",
178
+ "format": "boolean",
179
+ "default": "true"
180
+ },
181
+ {
182
+ "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
183
+ "description": "Directory inside the container where upstream Playwright MCP writes artifacts.",
184
+ "format": "filepath",
185
+ "default": "/data"
186
+ },
187
+ {
188
+ "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
189
+ "description": "Return snapshots, console logs, and network logs through stdout or files.",
190
+ "format": "string",
191
+ "default": "stdout"
192
+ },
193
+ {
194
+ "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
195
+ "description": "Patch upstream console message collection for CloakBrowser compatibility.",
196
+ "format": "boolean",
197
+ "default": "true"
198
+ },
199
+ {
200
+ "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
201
+ "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
202
+ "format": "string"
203
+ }
204
+ ]
205
+ },
206
+ {
207
+ "registryType": "oci",
208
+ "identifier": "docker.io/swimmwatch/cloakbrowser-mcp:1.2.7",
165
209
  "transport": {
166
210
  "type": "stdio"
167
211
  },