ext-apps/examples/integration-server
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Olivier Chafik 081dad83c4
fix: add error handling for server startup failures (#236)
Previously, if app.listen() failed (e.g., port already in use), the
server would fail silently. This adds proper error handling to log
the error and exit with a non-zero status code.

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

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 16:52:55 +00:00
..
src feat: publish example servers to npm (#184) 2026-01-08 20:08:50 +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-utils.ts fix: add error handling for server startup failures (#236) 2026-01-11 16:52:55 +00:00
server.ts feat: publish example servers to npm (#184) 2026-01-08 20:08:50 +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.