Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Jonathan Hefner 4140565b77 Improve consistency and organization of examples for AI learning - Add `.gitignore` files to all 19 examples (`node_modules/`, `dist/`) - Replace custom `log` objects with standard `console` methods - Add `ontoolcancelled` handler to all `basic-server-` examples - Add host styling integration (`applyDocumentTheme`, `applyHostFonts`, `applyHostStyleVariables`) to non-React `basic-server-` examples - Add section headers for better code organization in feature examples - Update READMEs with Build System section explaining single-file bundling These changes make examples more consistent and easier to adapt. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2026-01-13 20:48:02 -06:00
..
src	Improve consistency and organization of examples for AI learning	2026-01-13 20:48:02 -06:00
.gitignore	Improve consistency and organization of examples for AI learning	2026-01-13 20:48:02 -06:00
mcp-app.html	Add color-scheme meta tag to all example apps	2025-12-15 11:42:18 -08:00
package.json	chore: release 0.4.0 (#249 )	2026-01-12 22:40:24 +00:00
README.md	Improve consistency and organization of examples for AI learning	2026-01-13 20:48:02 -06:00
server-utils.ts	fix: add error handling for server startup failures (#236 )	2026-01-11 16:52:55 +00:00
server.ts	Replace deprecated `RESOURCE_URI_META_KEY` with `_meta.ui.resourceUri`	2026-01-12 13:00:11 -06:00
tsconfig.json	Add basic-server-vanillajs example	2025-12-04 14:28:27 -06:00
vite.config.ts	Add basic-server-vanillajs example	2025-12-04 14:28:27 -06:00

README.md

Example: Basic Server (Vanilla JS)

An MCP App example with a vanilla JavaScript UI (no framework).

Tip

Looking for a React-based example? See basic-server-react!

Overview

Tool registration with a linked UI resource
Vanilla JS UI using the App class directly
App communication APIs: callServerTool, sendMessage, sendLog, openLink
Theme integration via applyDocumentTheme(), applyHostStyleVariables(), and applyHostFonts()

Key Files

server.ts - MCP server with tool and resource registration
mcp-app.html / src/mcp-app.ts - Vanilla JS UI using App class

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.

Build System

This example bundles into a single HTML file using Vite with vite-plugin-singlefile — see vite.config.ts. This allows all UI content to be served as a single MCP resource. Alternatively, MCP apps can load external resources by defining _meta.ui.csp.resourceDomains in the UI resource metadata.