Tesseron

Типизированные действия в живых приложениях для ИИ-агентов, совместимых с MCP, через WebSocket.

Создано BrainBlend AI

НОВИНКА: Присоединяйтесь к нашему сообществу в Discord по адресу discord.gg/J3W9b5AZJR — вопросы по протоколу, отзывы и обсуждение вклада в SDK приветствуются.

Живые приложения (вкладки браузера, десктопные приложения Electron/Tauri, демоны Node, CLI) объявляют действия с помощью конструктора в стиле Zod; агенты (Claude Code, Claude Desktop, Cursor, Copilot, Codex, Cline и др.) вызывают их как инструменты MCP. Ваш реальный обработчик работает с вашим реальным состоянием. Никакой автоматизации браузера, никакого парсинга, никакого Playwright.

Почему Tesseron

• Типизированные действия, а не парсинг DOM. Объявляйте с помощью Zod или любого валидатора Standard Schema; обработчик — это обычная функция, работающая с вашим реальным состоянием.

• Не зависит от фреймворка. Тот же API для чистого TS, React, Svelte, Vue и Node. Выбирайте свой стек.

• MCP-native. Каждое действие, ресурс и возможность отображаются на стандартный примитив MCP. Пользователи выбирают своего агента.

• Подключение в один клик. Рукопожатие с помощью шестисимвольного кода подтверждения. Никаких API-ключей, никакой сложной настройки OAuth, никакой конфигурации для каждого клиента.

• Первоклассные возможности. ctx.confirm для подтверждения да/нет, ctx.elicit для подсказок с проверкой схемы, ctx.sample для вызовов LLM агента, ctx.progress для потоковых обновлений, подписываемые ресурсы для чтения в реальном времени.

• Комплексная доставка. Шлюз MCP поставляется внутри плагина Claude Code — одна команда установки, и все готово.

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

Быстрая установка (Claude Code)

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

Это устанавливает плагин Claude Code tesseron, который автоматически запускает шлюз MCP и регистрирует его как сервер MCP. Затем добавьте @tesseron/web, @tesseron/server или @tesseron/react в свое приложение, объявите действия и позвольте Claude управлять вашим реальным интерфейсом.

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();

Для других клиентов MCP (Claude Desktop, Cursor, Codex, VS Code Copilot и др.) см. однократную настройку в examples/README.md.

См. examples/ для работающих приложений на чистом TS, React, Svelte, Vue, Express и обычном Node.

Пакеты

Плагин Claude Code находится в plugin/ и доступен через манифест маркетплейса по адресу .claude-plugin/marketplace.json.

Поддержка возможностей клиента

Контекст действий Tesseron предоставляет обработчикам четыре возможности помимо простого вызова инструментов, каждая из которых поддерживается примитивом MCP. Будет ли фактически выполнен вызов, зависит от того, что заявляет клиент MCP пользователя:

Для получения авторитетного, постоянно обновляемого списка того, какой клиент поддерживает какой примитив, см. официальную матрицу совместимости клиентов MCP — отфильтруйте по Sampling или Elicitation, чтобы увидеть, насколько узка эта область. Несколько моментов, которые стоит знать перед выбором возможности:

• Инструменты универсальны — каждый клиент MCP может вызывать ваши действия.

• Sampling — самая редкая возможность. Claude Code, Claude Desktop и Claude.ai не предоставляют ее; текущая поддержка сосредоточена в VS Code + GitHub Copilot, goose и fast-agent.

• Elicitation (MCP 2025-06) появилась в Claude Code (2.1.76, март 2026), Cursor, Codex, VS Code Copilot, goose и fast-agent, но не в Claude Desktop, Claude.ai, ChatGPT, Windsurf или Zed.

• Когда возможность отсутствует, Tesseron вызывает типизированную ошибку (SamplingNotAvailableError, ElicitationNotAvailableError) или переходит к безопасному значению по умолчанию (ctx.confirm возвращает false), поэтому обработчики могут явно разветвляться, а не молча работать неправильно.

Статус

v1.0 выпущена в апреле 2026 года. Протокол стабилен на версии 1.0.0 и намеренно сделан компактным: двунаправленный JSON-RPC 2.0 через WebSocket, динамическая регистрация инструментов MCP, рукопожатие в один клик, потоковый прогресс, отмена, сэмплирование, подтверждение, получение данных с проверкой схемы, подписываемые ресурсы.

Опубликовано в npm (все версии v1.0.1): @tesseron/core, @tesseron/web, @tesseron/server, @tesseron/react, @tesseron/mcp. JS/TS SDK являются эталонной реализацией; спецификация протокола распространяется по лицензии CC BY 4.0, поэтому любой может написать совместимый клиент или сервер на любом языке.

В планах: адаптеры Svelte/Vue, интерфейс devtools, транспорт Streamable HTTP, Python SDK и привязки для десктопных сред выполнения (Rust для Tauri и т.д.).

Разработка

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

Вклад в проект

Отчеты об ошибках, уточнения протокола, новые адаптеры фреймворков и улучшения эталонной реализации приветствуются.

• Прочитайте CONTRIBUTING.md для ознакомления с рабочим процессом.

• Каждый коммит должен быть Signed-off-by: в соответствии с Сертификатом происхождения разработчика — используйте git commit -s.

• Сначала откройте issue для всего, что больше небольшого исправления.

История звезд

Лицензия

Эталонная реализация — Business Source License 1.1 (исходный код доступен). Вы можете встраивать Tesseron в свои приложения, использовать его внутри компании, форкать и свободно распространять. Вы не можете предлагать Tesseron или его значительную часть в качестве размещаемого или управляемого сервиса третьим лицам. Каждый релиз автоматически переходит на лицензию Apache-2.0 через четыре года после публикации.

Спецификация протокола — CC BY 4.0. Совместимая реализация на любом языке, для любых целей, включая коммерческие, прямо поощряется.

Вклад приветствуется в соответствии с Сертификатом происхождения разработчика — каждый коммит должен быть Signed-off-by.