Carga cápsulas de contexto firmadas y verificables en agentes de IA, rechazando contenido no firmado o no confiable para prevenir el envenenamiento de contexto.
También conocido como danielsoimu/altweb, altweb, altweb-context
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.1.2
- Último commit
- 13 oct 2026
- Licencia
- AGPL-3.0
¿Qué es ALTWEB Context Loader MCP?
Carga cápsulas de contexto firmadas y verificables en agentes de IA, rechazando contenido no firmado o no confiable para prevenir el envenenamiento de contexto.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ALTWEB Context Loader
La función principal de ALTWEB Context Loader es proteger las instrucciones y la memoria de los agentes de IA contra cambios no autorizados. Evita el envenenamiento de contexto asegurando que solo se inyecten en el flujo de trabajo de un agente cápsulas de markdown firmadas y verificables. Los desarrolladores utilizan el MCP server altweb-context para cargar estos archivos .altweb.html autocontenidos, que pueden comprimirse, encriptarse con AES-256-GCM o firmarse mediante ECDSA P-256.
Para usar este servidor, primero debes generar una identidad de firma usando el CLI altweb y añadir las claves públicas correspondientes a un archivo de confianza local. El cargador opera bajo un principio de rechazo, lo que significa que rechazará por defecto cualquier contenido no firmado o no confiable. Cuando un agente solicita contexto, el servidor utiliza las herramientas load_capsule, verify_capsule y list_trusted_keys para validar la procedencia de los datos antes de permitir que el markdown se inyecte en la sesión.
Qué puedes hacer con él
- 1Prevención del envenenamiento de contextoUn agente de IA puede negarse a cargar cualquier instrucción o archivo de personalidad que carezca de una firma criptográfica válida.
- 2Gestión de identidades confiablesPuedes restringir un agente para que solo acepte contexto de autores específicos y preaprobados mediante el mantenimiento de un archivo de confianza local.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ALTWEB Context Loader MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ALTWEB Context Loader MCP en Claude Code
$ claude mcp add altweb -- npx -y altweb-contextInstalar ALTWEB Context Loader MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}Instalar ALTWEB Context Loader MCP en VS Code
.vscode/mcp.json
{
"servers": {
"altweb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}Instalar ALTWEB Context Loader MCP en VS Code CLI
$ code --add-mcp '{"name":"altweb","type":"stdio","command":"npx","args":["-y","altweb-context"]}'Instalar ALTWEB Context Loader MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}Instalar ALTWEB Context Loader MCP en Codex
$ codex mcp add altweb -- npx -y altweb-contextInstalar ALTWEB Context Loader MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.altweb] command = "npx" args = ["-y", "altweb-context"]
Instalar ALTWEB Context Loader MCP en Gemini CLI
$ gemini mcp add -s user altweb npx -- -y altweb-contextInstalar ALTWEB Context Loader MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"altweb": {
"command": "npx",
"args": [
"-y",
"altweb-context"
]
}
}
}Configuración
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.
| Nombre | Descripción | Tipo |
|---|---|---|
| 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. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibledanielsoimu/altweb is public and reachablegithub.com/danielsoimu/altweb ↗Aprobado
- El paquete indica este repositorio como su origenaltweb-context names danielsoimu/altweb as sourcenpmjs.com/package/altweb-context ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for altweb-contextnpmjs.com/package/altweb-context/v/1.1.2#provenance ↗Aprobado
- Licencia de código abierto (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-13github.com/danielsoimu/altweb ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from altweb-contextAprobado
- No hay avisos críticos en el paquete ni en sus dependencias47 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubALTWEB — 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.
Preguntas sobre ALTWEB Context Loader MCP
¿Cómo agrego ALTWEB Context Loader MCP a Claude Code?
Ejecuta claude mcp add altweb -- npx -y altweb-context en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ALTWEB Context Loader MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué es una cápsula ALTWEB?
Una cápsula es un archivo markdown compilado en un único archivo .altweb.html o URL autocontenido que puede ser comprimido, encriptado y firmado.
¿Cómo maneja el servidor el contexto no confiable?
El servidor se niega a cargar cualquier cápsula que no esté firmada, que haya sido manipulada o que carezca de un firmante cuya clave pública esté en tu archivo de confianza local.
¿Cómo confío en un nuevo firmante?
Debes añadir la clave pública completa del firmante a tu archivo local trusted-keys.json.