sallyport
The Python MCP-server half of Sallyport — a security-first bridge between Claude Code (or any MCP client) and your Chrome, with explicit trust boundaries instead of implicit ones.
Claude Code ── MCP/stdio ──▶ daemon (this package) ── WS+HMAC ──▶ extension (MV3) ── CDP ──▶ Chrome
The daemon speaks MCP on stdio and hosts an HMAC-authenticated WebSocket server
on 127.0.0.1:10086 that the companion Chrome extension connects into. Every
frame is signed (HMAC-SHA256 + timestamp + nonce); the extension enforces a
per-domain allowlist and a per-domain opt-in for arbitrary JS.
Install
pip install sallyport
The package installs the sallyport-daemon console command.
Quickstart
sallyport-daemon doctor # check Python, secret file + perms, port; print the pairing block
claude mcp add sallyport sallyport-daemon # register with Claude Code
Then load the unpacked extension (or the release zip) from the main repository and paste the pairing block into its popup.
sallyport-daemon list-tools— print the tool catalogue (no daemon start)sallyport-daemon serve— WS-only mode (no MCP) for wire testingsallyport-daemon exec <tool> k=v …— fire one tool from the shell
Security
The full threat model, the load-bearing invariants, and known limitations live
in SECURITY.md.
In short: loopback-only bind, HMAC on every frame, a domain allowlist enforced
in the extension, per-domain evaluate opt-in, password-field gates, and
daemon-side filesystem sandboxes for upload/save_to_file.
License
MIT — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for sallyport 0.24.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sallyport-0.24.1.tar.gz | 97.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sallyport-0.24.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 202.9 kB
Release files / sallyport-0.24.1.tar.gz
| Download URL | sallyport-0.24.1.tar.gz |
|---|---|
| Size | 97.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c9a06c30c8a0cd363311bec155d1aa2e63233e6fb25dbd179a503020c6a704f4
|
|
BLAKE2b-256 checksum How to use checksums |
57078867c45d9a195eeb115b3318d7e2a5d3f9680d3485285e94c040c9971e50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / sallyport-0.24.1-py3-none-any.whl
| Download URL | sallyport-0.24.1-py3-none-any.whl |
|---|---|
| Size | 105.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc997fed241d1147e7fcdd541defbcf29f4c01741a443d2c5f916fcf34b58040
|
|
BLAKE2b-256 checksum How to use checksums |
64a88ae4f14367205523b2ae2525fde8eb92914a38c51b2e15cd59e010dd1eaa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency log
