yoke-mcp 0.1.6 → 0.1.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.
- package/README.md +4 -4
- package/ROADMAP.md +2 -1
- package/dist/mcp-server.d.ts +1 -1
- package/dist/mcp-server.js +1 -1
- package/extension/manifest.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -47,7 +47,7 @@ URL fields are reduced to origin and path by default, and `list_tabs` can opt ou
|
|
|
47
47
|
### Small and auditable
|
|
48
48
|
|
|
49
49
|
The package declares zero runtime dependencies and uses Node builtins only. The
|
|
50
|
-
published 0.1.
|
|
50
|
+
published 0.1.7 tarball is 47 files, all first-party.
|
|
51
51
|
|
|
52
52
|
TypeScript throughout with `strict` and `noUncheckedIndexedAccess` on. The wire
|
|
53
53
|
shapes are declared once in `src/protocol.ts` and imported by both halves, so a
|
|
@@ -64,7 +64,7 @@ judge rather than yours to discover.
|
|
|
64
64
|
|
|
65
65
|
The cells describe the verified versions and their defaults. Flags that change an answer are named in the cell or the numbered notes.
|
|
66
66
|
|
|
67
|
-
| Capability | Yoke (npm 0.1.
|
|
67
|
+
| Capability | Yoke (npm 0.1.7) | @playwright/mcp 0.0.79 (2026-08) | chrome-devtools-mcp 1.7.0 (pub. 2026-08-10) | BrowserMCP: server 0.1.3 (2025-04-11), extension 1.3.4 (2025-05-07), unmaintained |
|
|
68
68
|
| --- | --- | --- | --- | --- |
|
|
69
69
|
| Runs in the Chrome profile you are already signed in to | Yes. Chrome spawns the host via `connectNative`; there is no browser-launch code | No by default: its own persistent profile keyed to the client's cwd [1]. Yes with `--extension` | No by default: its own profile at `~/.cache/chrome-devtools-mcp/chrome-profile`. Yes with `--autoConnect` [2] | Yes. A Web Store extension in the running browser |
|
|
70
70
|
| Reaches tabs that were already open | Yes, every tab in every window of every Chrome profile the extension is loaded in [3] | No by default (fresh browser, so those tabs do not exist in it). Yes with `--extension` [4] | No by default. With `--autoConnect`, all windows of one profile [2] | One tab at a time, picked by the human in the popup. No tab listing and no tab creation tool [5] |
|
|
@@ -74,7 +74,7 @@ The cells describe the verified versions and their defaults. Flags that change a
|
|
|
74
74
|
| Runs with your existing cookies and logged-in session | Yes | No by default. Yes with `--extension` [12] | Only with `--autoConnect` [13] | Yes |
|
|
75
75
|
| Marks the tabs it touches | Yes. Any tab it drives or reads joins a visible tab group named "yoke" [14] | No in-tab marker. A separate headed window on its own profile, with automation signals actively suppressed [15] | Nothing added by the server. Chrome's own affordances only, and on `--autoConnect` that is a one-time consent dialog rather than an ongoing marker [16] | Chrome's own debugger infobar, incidental rather than designed, and suppressible [17] |
|
|
76
76
|
| URL redaction on by default | Yes. URL fields are cut to origin plus path; opt out with `full_urls` on `list_tabs` [18] | No. The only mechanism is opt-in substitution of known secret values (`--secrets`) | No, at no setting. Header redaction exists, covers headers only, and is off by default | No. The full page URL is in every snapshot header |
|
|
77
|
-
| Declared runtime dependencies, and install footprint | 0 declared, Node builtins only. The published 0.1.
|
|
77
|
+
| Declared runtime dependencies, and install footprint | 0 declared, Node builtins only. The published 0.1.7 tarball is 47 files, all first-party | 2 declared, both pinned to a 1.63.0 alpha. 19 MB installed. No browser download on the default `chrome` channel | 0 declared, and roughly 14 MB of vendored bundle (puppeteer 25.5.0, lighthouse 13.4.0) [19] | 5 declared, 97 transitive as resolved on 2026-08-24, and rising with no new release [20] |
|
|
78
78
|
|
|
79
79
|
#### Notes, including every place a flag or a version changes the answer
|
|
80
80
|
|
|
@@ -295,7 +295,7 @@ From a checkout that has not been linked, replace `yoke` with `node dist/cli.js`
|
|
|
295
295
|
5. Element references expire after navigation or a page render. Console and network history starts when yoke first attaches to that tab, not before.
|
|
296
296
|
6. Screenshots capture the page viewport, not browser chrome such as the address bar or tab strip.
|
|
297
297
|
7. Two different browsers that both run the extension, such as Chrome and Brave, number their tabs independently. A tab id both report is refused rather than routed, because it cannot be sent to both. Two profiles of the same Chrome never collide.
|
|
298
|
-
8. Chrome's internal pages cannot be read or driven. Neither can the Chrome Web Store or the extensions gallery: Chrome refuses both `chrome.scripting` and `chrome.debugger` there, so no extension can automate them, including this one.
|
|
298
|
+
8. Chrome's internal pages cannot be read or driven. Neither can the Chrome Web Store or the extensions gallery: Chrome refuses both `chrome.scripting` and `chrome.debugger` there, so no extension can automate them, including this one. Editing the store listing is therefore manual. Releases reach the store through its API from CI, as described in `docs/store-listing.md`.
|
|
299
299
|
|
|
300
300
|
## Uninstall
|
|
301
301
|
|
package/ROADMAP.md
CHANGED
|
@@ -40,6 +40,7 @@ Theme: prove the thesis. Built, working end to end, not yet tagged or published.
|
|
|
40
40
|
- An icon, at 16, 32, 48 and 128, drawn on an 8 unit grid so every line lands on a pixel boundary at 16.
|
|
41
41
|
- Offline tests for the MCP surface and the redaction, driven without a browser. CI green on Node 22 and 24 across Linux, macOS and Windows.
|
|
42
42
|
- 0.1.4: one endpoint per Chrome profile, named after an id the extension mints and keeps. `list_browsers` names each connected profile, `list_tabs` covers all of them, tab tools route by tab id, and `open_tab` takes `browser` when there is a choice. Closes the wrong-profile case in #6 and #8, where a single per-user endpoint was won by whichever profile connected first.
|
|
43
|
+
- 0.1.7: store releases come from CI. Every `v*` tag uploads the zip CI built to the Chrome Web Store and submits it for review once a person approves the `chrome-web-store` environment, through [publish-to-chrome-web-store](https://github.com/hamzahamidi/publish-to-chrome-web-store) with a 30 minute Workload Identity token, so the repository still holds no long-lived secret. Nothing in the extension or the host changed.
|
|
43
44
|
- 0.1.6: an endpoint is held only by a host that can serve it. Chrome can leave a host holding a pipe whose service worker is gone, and 0.1.5 let that host claim a socket which then accepted every caller and answered each one with a timeout, counted as a browser with no tabs, and kept the endpoint from the profile that could have served it (#19). A host now claims nothing unless the extension answers, gives the endpoint up when the extension stops answering, and waits for an incumbent to let go rather than unlinking a name a live server still holds.
|
|
44
45
|
- 0.1.5: a profile that loses the host comes back. Chrome stops an idle service worker, which takes the scheduled retry with it, so 0.1.4 could sit disconnected until somebody clicked the icon (#12). Browsing now wakes it, the backoff doubles as it always claimed to rather than staying at two seconds, and the message says to click the icon before it says to reinstall. Recovery on a browser nobody is touching is still open, in #15.
|
|
45
46
|
|
|
@@ -89,7 +90,7 @@ Theme: installable by someone who is not us. Done, inside the 0.1.x line rather
|
|
|
89
90
|
- On the Chrome Web Store as [Yoke](https://chromewebstore.google.com/detail/yoke/mebojgahcmmffbaonhnmmjhmbdbfbamm), with the privacy policy and the permission justifications `debugger` and host access had to defend. Review keeps its own clock, so the listing sits behind a release until it clears.
|
|
90
91
|
- The store does not honour the pinned `key`, which was the bullet that said verify, and the answer was no. A packaged upload may not carry one, so the store mints an id of its own: a store install is `mebojgahcmmffbaonhnmmjhmbdbfbamm` and an unpacked load stays `oceljemfocgfidhhdlbojkbkmlbfclna`. `yoke install` allowlists both, which is the only reason native messaging works either way.
|
|
91
92
|
- `yoke-mcp` is on npm. 0.1.0 went out by hand, because npm will not configure a trusted publisher for a package that does not exist yet. Every version since publishes from a `v*` tag over OIDC with provenance, and a person approves the `npm` environment before anything reaches the registry.
|
|
92
|
-
- The store package is built by CI from the tag and attached to the release with its SHA-256, so the zip
|
|
93
|
+
- The store package is built by CI from the tag and attached to the release with its SHA-256, so the zip that reaches the store is the one CI built and checked. Contents are reproducible: rebuilding 0.1.5 locally gives files byte identical to the release zip. The archive is not, because zip metadata differs, so an audit compares files rather than digests.
|
|
93
94
|
|
|
94
95
|
## v0.5.x: stabilisation
|
|
95
96
|
|
package/dist/mcp-server.d.ts
CHANGED
package/dist/mcp-server.js
CHANGED
|
@@ -14,7 +14,7 @@ import { createInterface } from 'node:readline';
|
|
|
14
14
|
import { allTabs, askTab, chooseBrowser, displayName, endpointForTabs, unplace, NoSuchBrowser, NoSuchTab, } from './browsers.js';
|
|
15
15
|
import { ask, ExtensionUnavailable, NOT_CONNECTED } from './socket-client.js';
|
|
16
16
|
export const SERVER_NAME = 'yoke';
|
|
17
|
-
export const SERVER_VERSION = '0.1.
|
|
17
|
+
export const SERVER_VERSION = '0.1.7';
|
|
18
18
|
export const PROTOCOL_VERSION = '2024-11-05';
|
|
19
19
|
/**
|
|
20
20
|
* The label on the group holding tabs yoke opened.
|
package/extension/manifest.json
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "yoke-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.7",
|
|
4
4
|
"description": "MCP server for the Chrome you are already signed in to. Every tab in every window, addressed by tab id, with no second profile and no browser-wide debugging port.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"yoke": "dist/cli.js"
|