Tesseron

Typisierte Live-App-Aktionen für MCP-kompatible KI-Agenten über WebSocket.

Entwickelt von BrainBlend AI

NEU: Treten Sie unserer Community auf Discord bei unter discord.gg/J3W9b5AZJR — Fragen zum Protokoll, Feedback und Chats zu SDK-Beiträgen sind willkommen.

Live-Anwendungen (Browser-Tabs, Electron/Tauri-Desktop-Apps, Node-Daemons, CLIs) deklarieren Aktionen mit einem Zod-artigen Builder; Agenten (Claude Code, Claude Desktop, Cursor, Copilot, Codex, Cline, ...) rufen diese als MCP-Tools auf. Ihr tatsächlicher Handler arbeitet direkt mit Ihrem echten Status. Keine Browser-Automatisierung, kein Scraping, kein Playwright.

Warum Tesseron

• Typisierte Aktionen, keine gescrapten DOMs. Deklarieren Sie mit Zod oder einem beliebigen Standard Schema Validator; der Handler ist eine einfache Funktion, die auf Ihrem echten Status operiert.

• Framework-agnostisch. Gleiche API für Vanilla TS, React, Svelte, Vue und Node. Wählen Sie Ihren Stack.

• MCP-nativ. Jede Aktion, Ressource und Fähigkeit wird auf ein Standard-MCP-Primitiv abgebildet. Benutzer wählen ihren Agenten.

• Click-to-connect. Handshake mit sechsstelligen Claim-Codes. Keine API-Schlüssel, kein OAuth-Aufwand, keine Konfiguration pro Client.

• Erstklassige Fähigkeiten. ctx.confirm für Ja/Nein, ctx.elicit für schema-validierte Eingabeaufforderungen, ctx.sample für Agenten-LLM-Aufrufe, ctx.progress für Streaming-Updates, abonnierbare Ressourcen für Live-Lesevorgänge.

• Gebündelte Bereitstellung. Das MCP-Gateway wird innerhalb eines Claude Code Plugins ausgeliefert — ein Installationsbefehl und Sie sind fertig.

Related MCP server: Touch Flow Base (MCP Counter POC)

Schnellinstallation (Claude Code)

/plugin marketplace add BrainBlend-AI/tesseron
/plugin install tesseron@tesseron

Dies installiert das tesseron Claude Code Plugin, das das MCP-Gateway automatisch startet und als MCP-Server registriert. Binden Sie dann @tesseron/web, @tesseron/server oder @tesseron/react in Ihre App ein, deklarieren Sie Aktionen und lassen Sie Claude Ihre echte Benutzeroberfläche steuern.

import { tesseron } from '@tesseron/web';
import { z } from 'zod';

tesseron.app({ id: 'todo_app', name: 'Todo App' });

tesseron
  .action('addTodo')
  .input(z.object({ text: z.string().min(1) }))
  .handler(({ text }) => {
    state.todos.push({ id: newId(), text, done: false });
    render();
    return { ok: true };
  });

await tesseron.connect();

Für andere MCP-Clients (Claude Desktop, Cursor, Codex, VS Code Copilot, ...) siehe die einmalige Einrichtung in examples/README.md.

Siehe examples/ für funktionierende Apps in Vanilla TS, React, Svelte, Vue, Express und einfachem Node.

Pakete

Das Claude Code Plugin befindet sich unter plugin/ und wird über das Marketplace-Manifest unter .claude-plugin/marketplace.json bereitgestellt.

Unterstützung von Client-Fähigkeiten

Der Aktionskontext von Tesseron bietet Handlern vier Fähigkeiten über den einfachen Tool-Aufruf hinaus, die jeweils durch ein MCP-Primitiv unterstützt werden. Ob ein Aufruf tatsächlich ausgelöst wird, hängt davon ab, was der MCP-Client des Benutzers ankündigt:

Für die maßgebliche, kontinuierlich aktualisierte Liste, welcher Client welches Primitiv unterstützt, siehe die offizielle MCP-Client-Kompatibilitätsmatrix — filtern Sie nach Sampling oder Elicitation, um zu sehen, wie begrenzt das Feld noch ist. Ein paar Punkte, die Sie kennen sollten, bevor Sie eine Fähigkeit auswählen:

• Tools sind universell — jeder MCP-Client kann Ihre Aktionen aufrufen.

• Sampling ist am seltensten. Claude Code, Claude Desktop und Claude.ai unterstützen es nicht; die heutige Unterstützung konzentriert sich auf VS Code + GitHub Copilot, goose und fast-agent.

• Elicitation (MCP 2025-06) wurde in Claude Code (2.1.76, März 2026), Cursor, Codex, VS Code Copilot, goose und fast-agent eingeführt, aber nicht in Claude Desktop, Claude.ai, ChatGPT, Windsurf oder Zed.

• Wenn eine Fähigkeit fehlt, löst Tesseron einen typisierten Fehler aus (SamplingNotAvailableError, ElicitationNotAvailableError) oder greift auf den sicheren Standard zurück (ctx.confirm gibt false zurück), sodass Handler explizit verzweigen können, anstatt sich stillschweigend falsch zu verhalten.

Status

v1.0 wurde im April 2026 veröffentlicht. Das Protokoll ist stabil unter 1.0.0 und bewusst klein gehalten: bidirektionales JSON-RPC 2.0 über WebSocket, dynamische MCP-Tool-Registrierung, Click-to-connect-Handshake, Streaming-Fortschritt, Abbruch, Sampling, Bestätigung, schema-validierte Elicitation, abonnierbare Ressourcen.

Veröffentlicht auf npm (alle unter v1.0.1): @tesseron/core, @tesseron/web, @tesseron/server, @tesseron/react, @tesseron/mcp. Die JS/TS-SDKs sind die Referenzimplementierung; die Protokollspezifikation ist CC BY 4.0, sodass jeder einen kompatiblen Client oder Server in jeder Sprache schreiben kann.

Auf der Roadmap: Svelte/Vue-Adapter, die Devtools-UI, ein Streamable HTTP-Transport, ein Python-SDK und Bindings für Desktop-native Runtimes (Rust für Tauri, etc.).

Entwicklung

pnpm install
pnpm typecheck
pnpm test                                    # 65 tests across core + mcp
pnpm --filter @tesseron/mcp build:plugin     # rebuild plugin/server/index.cjs after gateway changes

Mitwirken

Fehlerberichte, Protokollverfeinerungen, neue Framework-Adapter und Verbesserungen an der Referenzimplementierung sind willkommen.

• Lesen Sie CONTRIBUTING.md für den Workflow.

• Jeder Commit muss unter dem Developer Certificate of Origin Signed-off-by: sein — verwenden Sie git commit -s.

• Eröffnen Sie zuerst ein Issue für alles, was über eine kleine Korrektur hinausgeht.

Star-Verlauf

Lizenz

Referenzimplementierung — Business Source License 1.1 (Quellcode verfügbar). Sie dürfen Tesseron in Ihre eigenen Anwendungen einbetten, intern verwenden, forken und frei weitergeben. Sie dürfen Tesseron oder einen wesentlichen Teil davon nicht als gehosteten oder verwalteten Dienst an Dritte anbieten. Jede Version wird vier Jahre nach Veröffentlichung automatisch auf Apache-2.0 umgestellt.

Protokollspezifikation — CC BY 4.0. Eine kompatible Implementierung in jeder Sprache, für jeden Zweck einschließlich kommerzieller Nutzung, wird ausdrücklich gefördert.

Beiträge sind unter dem Developer Certificate of Origin willkommen — jeder Commit muss Signed-off-by sein.