ext-apps/examples/integration-server
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jonathan Hefner 79670b4dcd
Add safeAreaInsets support to all example apps (#202)
Apply host-provided safe area insets as padding on main containers
across all examples. This ensures content doesn't render under
system UI elements like phone notches.

React apps use `useState` + `onhostcontextchanged` handler with
initial fetch via `getHostContext()` in `useEffect`. Vanilla JS
apps apply padding in the handler and invoke it after `connect()`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 18:03:13 +00:00
..
src Add safeAreaInsets support to all example apps (#202) 2026-01-08 18:03:13 +00:00
mcp-app.html Clean up examples (#182) 2025-12-19 11:44:27 +00:00
package.json Clean up examples (#182) 2025-12-19 11:44:27 +00:00
README.md Clean up examples (#182) 2025-12-19 11:44:27 +00:00
server.ts Clean up examples (#182) 2025-12-19 11:44:27 +00:00
tsconfig.json Clean up examples (#182) 2025-12-19 11:44:27 +00:00
vite.config.ts Clean up examples (#182) 2025-12-19 11:44:27 +00:00

Example: Integration Test Server

An MCP App example used for E2E integration testing.

Overview

This example demonstrates all App SDK communication APIs and is used by the E2E test suite to verify host-app interactions:

Key Files

Getting Started

npm install
npm run dev

How It Works

  1. The server registers a get-time tool with metadata linking it to a UI HTML resource (ui://get-time/mcp-app.html).
  2. When the tool is invoked, the Host renders the UI from the resource.
  3. The UI uses the MCP App SDK API to communicate with the host and call server tools.