Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Maurizio Albari b594fc2dbd fix: update serve:http to run main.ts instead of server.ts (#315 ) After commit `65a62a9f`, the server startup code was moved from server.ts to main.ts, but the serve:http script was not updated accordingly. This caused 9 example servers to fail to start when running npm start: - budget-allocator-server - cohort-heatmap-server - customer-segmentation-server - integration-server - map-server - scenario-modeler-server - system-monitor-server - threejs-server - wiki-explorer-server The server.ts file now only exports createServer(), while main.ts contains the actual server startup logic.		2026-01-20 17:57:08 +00:00
..
src	fix(e2e): make server-time element fill width for consistent mask (#283 )	2026-01-19 17:01:55 +00:00
.gitignore	Improve consistency and organization of examples for AI learning	2026-01-13 20:48:02 -06:00
main.ts	feat: compile example servers to JavaScript for npm consumption (#259 )	2026-01-14 23:46:17 +00:00
mcp-app.html	Clean up examples (#182 )	2025-12-19 11:44:27 +00:00
package.json	fix: update serve:http to run main.ts instead of server.ts (#315 )	2026-01-20 17:57:08 +00:00
README.md	Clean up examples (#182 )	2025-12-19 11:44:27 +00:00
server.ts	fix(examples): resolve DIST_DIR path for npm package execution (#277 )	2026-01-15 12:23:13 +00:00
tsconfig.json	Clean up examples (#182 )	2025-12-19 11:44:27 +00:00
tsconfig.server.json	feat: compile example servers to JavaScript for npm consumption (#259 )	2026-01-14 23:46:17 +00:00
vite.config.ts	Clean up examples (#182 )	2025-12-19 11:44:27 +00:00

README.md

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:

Tool registration with a linked UI resource
React UI using the useApp() hook
App communication APIs: callServerTool, sendMessage, sendLog, openLink

Key Files

server.ts - MCP server with tool and resource registration
mcp-app.html / src/mcp-app.tsx - React UI using useApp() hook

Getting Started

npm install
npm run dev

How It Works

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