Tesseron

WebSocket을 통한 MCP 호환 AI 에이전트용 타입 지정 라이브 앱 작업.

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 유효성 검사기로 선언하세요. 핸들러는 실제 상태에 대한 일반 함수입니다.

• 프레임워크 독립적. Vanilla TS, React, Svelte, Vue, Node에서 동일한 API를 사용합니다. 원하는 스택을 선택하세요.

• MCP 네이티브. 모든 작업, 리소스, 기능은 표준 MCP 기본 요소에 매핑됩니다. 사용자가 에이전트를 선택합니다.

• 클릭 한 번으로 연결. 6자리 인증 코드 핸드셰이크. API 키, OAuth 과정, 클라이언트별 설정이 필요 없습니다.

• 일류 기능. 예/아니오를 위한 ctx.confirm, 스키마 검증 프롬프트를 위한 ctx.elicit, 에이전트 LLM 호출을 위한 ctx.sample, 스트리밍 업데이트를 위한 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

이 명령은 tesseron Claude Code 플러그인을 설치하며, 자동으로 MCP 게이트웨이를 생성하고 MCP 서버로 등록합니다. 그런 다음 @tesseron/web, @tesseron/server 또는 @tesseron/react를 앱에 추가하고 작업을 선언하면 Claude가 실제 UI를 제어하게 됩니다.

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의 1회성 설정을 참조하세요.

Vanilla TS, React, Svelte, Vue, Express 및 일반 Node에서 작동하는 앱 예제는 examples/를 확인하세요.

패키지

Claude Code 플러그인은 plugin/에 있으며, .claude-plugin/marketplace.json의 마켓플레이스 매니페스트를 통해 노출됩니다.

클라이언트 기능 지원

Tesseron의 작업 컨텍스트는 일반 도구 호출 외에 4가지 기능을 핸들러에 제공하며, 각 기능은 MCP 기본 요소로 지원됩니다. 특정 호출이 실제로 실행되는지는 사용자의 MCP 클라이언트가 무엇을 광고하는지에 따라 다릅니다:

어떤 클라이언트가 어떤 기본 요소를 지원하는지에 대한 권위 있고 지속적으로 업데이트되는 목록은 **공식 MCP 클라이언트 호환성 매트릭스**를 참조하세요. Sampling 또는 Elicitation으로 필터링하여 지원 범위를 확인하세요. 기능을 선택하기 전에 알아두어야 할 몇 가지 사항:

• **도구(Tools)**는 보편적입니다. 모든 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년 3월), Cursor, Codex, VS Code Copilot, goose, fast-agent에 도입되었으나, Claude Desktop, Claude.ai, ChatGPT, Windsurf, Zed에는 도입되지 않았습니다.

• 기능이 누락된 경우, Tesseron은 타입이 지정된 오류(SamplingNotAvailableError, ElicitationNotAvailableError)를 발생시키거나 안전한 기본값(ctx.confirm은 false 반환)으로 대체하므로, 핸들러가 조용히 잘못 작동하는 대신 명시적으로 분기할 수 있습니다.

상태

v1.0은 2026년 4월에 출시되었습니다. 프로토콜은 1.0.0에서 안정화되었으며 의도적으로 작게 유지되었습니다: WebSocket을 통한 양방향 JSON-RPC 2.0, 동적 MCP 도구 등록, 클릭 한 번으로 연결되는 핸드셰이크, 스트리밍 진행률, 취소, 샘플링, 확인, 스키마 검증된 Elicitation, 구독 가능한 리소스.

npm에 게시됨 (모두 v1.0.1): @tesseron/core, @tesseron/web, @tesseron/server, @tesseron/react, @tesseron/mcp. JS/TS SDK는 참조 구현입니다. 프로토콜 사양은 CC BY 4.0이므로 누구나 어떤 언어로든 호환되는 클라이언트나 서버를 작성할 수 있습니다.

로드맵: Svelte/Vue 어댑터, 개발자 도구 UI, 스트리밍 가능한 HTTP 전송, Python SDK, 데스크톱 네이티브 런타임용 바인딩(Tauri용 Rust 등).

개발

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를 사용하세요.

• 작은 수정보다 큰 변경 사항은 먼저 이슈를 열어주세요.

스타 기록

라이선스

참조 구현 — Business Source License 1.1 (소스 공개). Tesseron을 자신의 애플리케이션에 포함하거나, 내부적으로 사용하거나, 포크하거나, 자유롭게 재배포할 수 있습니다. Tesseron 또는 그 상당 부분을 제3자에게 호스팅 또는 관리형 서비스로 제공할 수는 없습니다. 각 릴리스는 게시 후 4년이 지나면 Apache-2.0으로 자동 전환됩니다.

프로토콜 사양 — CC BY 4.0. 상업적 목적을 포함한 모든 목적을 위해 어떤 언어로든 호환되는 구현을 만드는 것을 명시적으로 권장합니다.

개발자 원산지 증명서에 따른 기여를 환영합니다. 모든 커밋에는 Signed-off-by가 포함되어야 합니다.