Lädt signierte und verifizierbare Context Capsules in AI Agents und verweigert nicht signierte oder nicht vertrauenswürdige Inhalte, um Context Poisoning zu verhindern.
Auch bekannt als danielsoimu/altweb, altweb, altweb-context
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.2
- Letzter Commit
- 13. Okt. 2026
- Lizenz
- AGPL-3.0
Was ist ALTWEB Context Loader MCP?
Lädt signierte und verifizierbare Context Capsules in AI Agents und verweigert nicht signierte oder nicht vertrauenswürdige Inhalte, um Context Poisoning zu verhindern.
Zusammenfassung generiert aus dem README des Projekts
Über ALTWEB Context Loader MCP server
Die primäre Funktion des ALTWEB Context Loader ist es, die Anweisungen und das Gedächtnis von AI Agents vor unbefugten Änderungen zu schützen. Er verhindert Context Poisoning, indem er sicherstellt, dass nur signierte und verifizierbare Markdown Capsules in den Workflow eines Agents injiziert werden. Entwickler nutzen den altweb-context MCP server, um diese eigenständigen .altweb.html Dateien zu laden, die komprimiert, mit AES-256-GCM verschlüsselt oder mittels ECDSA P-256 signiert werden können.
Um diesen Server zu nutzen, musst du zuerst eine Signing Identity über das altweb CLI generieren und die entsprechenden Public Keys zu einer lokalen Trust-Datei hinzufügen. Der Loader arbeitet nach dem Prinzip der Verweigerung, was bedeutet, dass er standardmäßig alle nicht signierten oder nicht vertrauenswürdigen Inhalte ablehnt. Wenn ein Agent Context anfordert, nutzt der Server die Tools load_capsule, verify_capsule und list_trusted_keys, um die Herkunft der Daten zu validieren, bevor das Markdown in die Session injiziert wird.
Was du damit machen kannst
- 1Verhindern von Context PoisoningEin AI Agent kann sich weigern, Anweisungen oder Persona-Dateien zu laden, denen eine gültige kryptografische Signatur fehlt.
- 2Verwalten vertrauenswürdiger IdentitätenDu kannst einen Agenten so einschränken, dass er Context nur von spezifischen, vorab genehmigten Autoren akzeptiert, indem du eine lokale Trust-Datei pflegst.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ALTWEB Context Loader MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenALTWEB Context Loader MCP in Claude Code installieren
$ claude mcp add altweb -- npx -y altweb-contextALTWEB Context Loader MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}ALTWEB Context Loader MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"altweb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}ALTWEB Context Loader MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"altweb","type":"stdio","command":"npx","args":["-y","altweb-context"]}'ALTWEB Context Loader MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}ALTWEB Context Loader MCP in Codex installieren
$ codex mcp add altweb -- npx -y altweb-contextALTWEB Context Loader MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.altweb] command = "npx" args = ["-y", "altweb-context"]
ALTWEB Context Loader MCP in Gemini CLI installieren
$ gemini mcp add -s user altweb npx -- -y altweb-contextALTWEB Context Loader MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}Konfiguration
ALTWEB_TRUST_FILEOverride the local trust file of allowed signer public keys (default: ~/.altweb/trusted-keys.json). A missing or empty trust file refuses every capsule.
| Name | Beschreibung | Typ |
|---|---|---|
| ALTWEB_TRUST_FILE | Override the local trust file of allowed signer public keys (default: ~/.altweb/trusted-keys.json). A missing or empty trust file refuses every capsule. |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbardanielsoimu/altweb is public and reachablegithub.com/danielsoimu/altweb ↗Bestanden
- Paket nennt dieses Repository als Quellealtweb-context names danielsoimu/altweb as sourcenpmjs.com/package/altweb-context ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for altweb-contextnpmjs.com/package/altweb-context/v/1.1.2#provenance ↗Bestanden
- Open Source Lizenz (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-13github.com/danielsoimu/altweb ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from altweb-contextBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten47 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenALTWEB — signed context capsules
Signed context capsules for AI agents — Markdown compiled into self-contained, verifiable, optionally encrypted artifacts + an MCP loader that refuses unsigned or untrusted context. Verify before you inject.
AI agents run on plain-text context: instructions, personas, skills, memory files. None of it has provenance — anything that can write those files can poison them. ALTWEB gives context a chain of custody, and makes the loader refuse anything that lacks one:
- Capsule — markdown compiled into a single
.altweb.htmlfile (or URL): content compressed (deflate), optionally encrypted (AES-256-GCM), optionally signed (ECDSA P-256). Self-contained — opens in any browser, verifies offline, needs no server: you hand someone a file, not a database. - Verified context loading — the
altweb-contextMCP server loads a capsule into your agent only when the signature is valid and the signer's public key is in your trust file. Unsigned, tampered, or untrusted capsules are refused at load time, with an explicit reason. Refusal is the default: an empty trust file rejects everything, signed or not.
you write MD ──► altweb compile --sign ──► capsule (.altweb.html / URL)
│
agent asks for context ──► altweb-context ──► verify signature + trust
│
trusted ──► markdown injected
everything else ──► REFUSED (reason)
Packages
| Package | What it is |
|---|---|
altweb |
CLI: altweb compile / decode / verify / keygen (packages/cli) |
altweb-context |
MCP server: load_capsule, verify_capsule, list_trusted_keys (packages/mcp) |
@altweb/core |
Headless engine: content model, codec, crypto, markdown, sanitize (bundled into both; npm release planned) |
@altweb/editor |
Notion-style editor (built on Novel) with one-click capsule export |
site/ |
Documentation site (Astro + Starlight) |
Quickstart
Both tools are on npm — nothing to clone. Run these commands outside a source checkout (inside this repository, npm resolves the local workspace package):
# create your signing identity (deterministic from a passphrase; only the
# public key + fingerprint are stored, in ~/.altweb/identity.json)
npx altweb keygen --save
# write, compile, sign
echo "# My agent's operating notes" > notes.md
npx altweb compile notes.md -o notes.altweb.html --sign
# verify anywhere, offline
npx altweb verify notes.altweb.html
Wire the loader into an MCP client (Claude Code example):
claude mcp add altweb-context -- npx -y altweb-context
(From source: npm install && npm run build, then use the bundles under
packages/*/dist/.)
Running from source
Node.js 20 or newer is required. From the repository root:
npm install
npm run build
# Create and save an identity with the locally built CLI
npm run keygen
# Start the editor in development mode
npm run dev
The editor prints its local URL (normally http://localhost:5173). The CLI can
be invoked as node packages/cli/dist/altweb.mjs <command>. Do not use npx altweb inside the checkout: npm may select the local workspace package, whose
executable does not exist until it has been built.
The documentation site is intentionally a separate npm project rather than a workspace. To run it locally:
npm install --prefix site
npm run dev --prefix site
Trust a signer by adding its full public key to ~/.altweb/trusted-keys.json
(the UNTRUSTED_KEY refusal message hands you the ready-made entry; the short
fingerprint is a human label, not the trust anchor):
{ "keys": [ { "name": "Me", "publicKey": "<base64url SPKI>", "fingerprint": "ab:12:..." } ] }
What a signature proves — and what it does not
A valid signature proves who authored the capsule and that the bytes are intact. It does not make the content safe or true. The trust file is your policy; keep it short.
Pick a long passphrase. Identities derive deterministically from your passphrase via Argon2id with a fixed protocol salt (that is what makes them portable with nothing stored). Memory-hardness makes mass dictionary attacks economically hostile, but the passphrase's entropy is still the identity's foundation. Use a 16+ character diceware-style phrase; the tooling enforces a minimum strength.
Security
Content is sanitized with DOMPurify on decode; artifacts carry a CSP; the
codec validates structure with zod. See site/ docs → Security model for the
full write-up, including the encrypted-capsule caveat (the signature covers
the decrypted payload, so verification completes after decryption).
Roadmap
Near-term, in rough order:
@altweb/coreon npm — the engine as an installable library, for programmatic use (the CLI and loader already ship it bundled).- Hardware-backed identity (FIDO2 / passkeys) — an optional identity type alongside the passphrase one: the private key lives in a security key or secure enclave, never extractable, signing requires physical presence. The passphrase identity stays the default — "a passphrase is a keypair" — hardware keys add something you have for those who want it.
Credits
Built on excellent open source: Novel (Apache-2.0) and Tiptap (MIT) for the editor; DOMPurify, marked, pako, zod, @noble/curves in the engine. See NOTICE.
License
ALTWEB is dual-licensed:
- Open source: AGPL-3.0-or-later. Free to use, study, modify,
and share — with one core obligation: if you modify ALTWEB and distribute it
or run it as a network service (e.g. hosting
altweb-contextfor others), you must release your modified source under the AGPL. - Commercial: by agreement. To use ALTWEB in a closed-source product, or as a hosted service without publishing your changes, you need a separate commercial license. See COMMERCIAL.md.
Copyright © 2026 Daniel C. ȘOIMU. Bundled third-party components keep their own (permissive) licenses — see NOTICE.
ALTWEB Context Loader MCP Fragen
Wie füge ich ALTWEB Context Loader MCP zu Claude Code hinzu?
Führe claude mcp add altweb -- npx -y altweb-context in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ALTWEB Context Loader MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was ist eine ALTWEB Capsule?
Eine Capsule ist eine Markdown-Datei, die in eine einzige, eigenständige .altweb.html-Datei oder URL kompiliert werden kann, die komprimiert, verschlüsselt und signiert werden kann.
Wie geht der Server mit nicht vertrauenswürdigem Context um?
Der Server verweigert das Laden jeder Capsule, die nicht signiert ist, manipuliert wurde oder keinen Signer hat, dessen Public Key in deiner lokalen Trust-Datei hinterlegt ist.
Wie vertraue ich einem neuen Signer?
Du musst den vollständigen Public Key des Signers zu deiner lokalen trusted-keys.json hinzufügen.