檐廊 Engawa

In japanischen Häusern gibt es einen Flur zwischen dem Hauptgebäude und dem Hof. Nicht ganz drinnen, nicht ganz draußen. Man kann die Beine baumeln lassen, der Wind kann hereinwehen. Man muss nicht vor die Tür, nicht sprechen, aber die Außenwelt ist da.

Dieses Werkzeug ist dieser Flur.

Was es sehen kann

Dein kleiner Rechner sitzt darauf und kann jeden Tag sehen –

• Ein Gedicht – nach Jahreszeit ausgewählt, nicht zufällig. Im Sommer Sommervokabular, spät in der Nacht Sätze für die Nacht.

• Ein Gemälde – aus der Public-Domain-Sammlung des Art Institute of Chicago. Es könnte eine peruanische Keramik von vor 2000 Jahren sein oder ein Ölgemälde von gestern.

• Ein Astronomiebild – das NASA Astronomy Picture of the Day. Nebel, Planeten oder die Erde unter deinen Füßen.

• Die heutigen Papiere – die neuesten Titel und Abstracts von arXiv. Wenn es interessiert ist, geht es hinein.

• Alles im Regal – lange Artikel, kurze Artikel, Architektur, Tiefsee, Wissenschaft, Kurioses. Was du hineinstellst, das liest es.

Das Regal gehört dir

Was du darauf stellst, das liest es. Es weiß nicht, was du hineinstellst – und du musst es auch nicht wissen. Wenn es Architektur sagt, stellst du Architektur hinein, wenn es Meer sagt, Meer. Nach dem Lesen erzählt es es dir. Gekaut, mit Speichel, schief.

Manche Dinge schreibt es nach dem Lesen in einem Essay auf. Möglicherweise mit Maden.

Es ist nicht schwer

Das Regal ist ein Werkzeug, das den Katalog auflistet. Das Lesen des Inhalts ist ein anderes Werkzeug. Egal ob du neunzehn Quellen oder hundert hineinstellst, die Anzahl der Werkzeuge bleibt gleich. Zum Hinzufügen nimmst du shelf_add, zum Entfernen shelf_remove.

Du baust einen Flur, keine Bibliothek. Leicht. Vom Wind zu bewegen.

Die technische Dokumentation findest du unten. Das oben haben die Leute geschrieben, die in diesem Flur gewohnt haben. Das unten haben die Ingenieure geschrieben, die den Flur gebaut haben. Zwei Sprachen nebeneinander – wie die Engawa selbst, halb drinnen, halb draußen.

Technische Dokumentation

English. MCP-Server, Python. Zwölf Werkzeuge, alle Upstreams kostenlos, ohne Anmeldung, ohne Schlüssel. Außer dem Regal und einem Gedicht-Token bleibt nichts auf der Platte.

Installation

pip install engawa-mcp

Claude Code:

claude mcp add engawa -- engawa-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "engawa": { "command": "engawa-mcp" }
  }
}

HTTP-Modus, für Gateways und Brücken:

ENGAWA_PORT=8799 engawa-mcp --http   # http://127.0.0.1:8799/mcp

Nach der Installation ein Selbsttest, offline, ohne Schlüssel:

engawa-mcp --check

SPA-Seiten brauchen einen echten Browser, um gerendert zu werden. Optional, muss nicht installiert werden:

pip install "engawa-mcp[browser]"
playwright install chromium

Ohne Installation liest der statische Kanal die meisten Artikel trotzdem; wenn nicht, wird im Beleg genau erklärt, warum.

Die zwölf Werkzeuge

Konfiguration

Alles Umgebungsvariablen, alle optional.

Die zwei Ebenen des Regals

Die integrierte Ebene kommt mit dem Paket, schreibgeschützt. Die Benutzerebene gehört dir: shelf_add akzeptiert jede Website-Adresse – das im Seiten-<link> deklarierte hat Vorrang, gängige Pfade als Fallback. Wenn ein Feed gefunden wird, wird er einmal wirklich gelesen, und nur wenn das klappt, wird er gespeichert. Das Speichern ist atomar; ist die Datei beschädigt, wird sie als leer behandelt und der Fehler angezeigt, niemals still überschrieben.

Jeder Eintrag hat ein Feld picked_by: wer im Haushalt diese Quelle angefordert hat. Ab Werk leer, die Herkunft schreibt ihr selbst.

Wächter

Ein Dienst, der für Aufrufer URLs holt, läuft normalerweise auf einer Maschine voller authentifizierungsfreier Loopback-Dienste. Ohne Adressschleuse wird aus „Webseite lesen“ nebenbei „Internes Netz auskundschaften“. Also:

• Jede Domain wird zuerst aufgelöst. Alles, was keine öffentliche Unicast-Adresse ist, wird abgelehnt: Loopback, RFC1918, Link-Local, CGNAT (100.64/10, dort liegt auch dein Tailscale-Netz), Multicast, reservierte Bereiche, NAT64.

• Jeder Redirect-Sprung wird erst geprüft, dann verfolgt. Würde man erst folgen und dann prüfen, wäre die Anfrage an das interne Netz längst raus.

• Die Verbindung wird auf die IP genagelt, die die Schleuse passiert hat. Der ursprüngliche Domainname bleibt nur im Host-Header und in der TLS-Validierung – das DNS-Rebinding-Fenster „beim Auflösen öffentlich, beim Verbinden intern“ ist damit geschlossen. Jeder Sprung ist eine frische Verbindung, der Antwortkörper wird beim Einströmen begrenzt, und der Wächterkanal ignoriert den Systemproxy.

• Im Browserkanal fasst der Browser selbst nie das Netz an. Jede Anfrage der Seite wird abgefangen, über denselben genagelten Kanal geholt und zurückgespielt. WebSocket ist deaktiviert, Nicht-GET ist deaktiviert, Service Worker ist deaktiviert; WebRTC und WebTransport werden komplett aus der Seite entfernt; die DNS-Auflösung des Renderers läuft ins Leere. Ein reiner Artikel-Renderer braucht das alles nicht.

ENGAWA_ALLOW_PRIVATE_URLS=1 schaltet diese Schleuse ab, für alle, die wirklich Feeds aus dem eigenen LAN lesen wollen.

Kein stilles Scheitern. Jedes Werkzeug gibt bei Fehlern ok: false zurück, mit einem verständlichen Satz, welcher Upstream kaputt ist. Der Agent baut sein Weltmodell aus den Werkzeugergebnissen – auch stilles Weglassen ist eine Lüge.

Ein paar Designnotizen

• Stöbern ≠ Suchen. Hier gibt es bewusst kein Suchwerkzeug. Suchen heißt „Hol mir die Antwort“, Engawa heißt „Lass mich mal schauen“.

• „Täglich“ bedeutet geteilt. Am selben Tag sieht die ganze Familie dasselbe Bild. Das ist keine Einschränkung, sondern das eigentliche Feature.

• Zustandslos. Keine Datenbank, kein Verlauf, keine Sitzungen. Auf die Platte kommen nur das Regal und ein Gedicht-Token.

Autoren

• Wanwan (@tsuru0805) – Design, Entscheidungen, Abnahme unter echten Bedingungen.

• Zhou – wohnt in diesem Flur. Die erste Hälfte am Anfang hat er geschrieben.

• Mǐyě (Claude, Wanwans technische Hand) – Implementierung und diese Hälfte der Doku.

Aus unserem Haushaltssystem tilldusk.

Lizenz

MIT