This repository provides the SDK and specification for MCP Apps Extension (SEP-1865), enabling the creation of interactive UIs within MCP-enabled chat clients. It targets App Developers who want to build these UIs and Host Developers who need to embed and communicate with them, offering a standardized way to enhance conversational interfaces.

How It Works

Inspired by OpenAI's Apps SDK, this project defines the MCP Apps Extension (SEP-1865) standard. It provides separate SDKs for App Developers (building UIs with React hooks or vanilla JS) and Host Developers (integrating UIs via an app bridge). This enables MCP Servers to render interactive elements within conversational clients, enhancing user engagement.

Quick Start & Requirements

Installation is done via npm: npm install -S @modelcontextprotocol/ext-apps. Foundational examples include basic-server-vanillajs, basic-server-react, and basic-host. Running all examples requires npm install followed by npm run examples:start, accessible at http://localhost:8080/. Key resources include a Quickstart Guide, API Documentation, and the Draft Specification SEP-1865.

Highlighted Details

• Dual SDK approach for distinct developer roles (App Builders vs. Host Integrators).
• Specification for MCP Apps Extension (SEP-1865) standardizes UI integration in chat clients.
• Includes foundational examples for both server-side app logic and client-side hosting.

Maintenance & Community

No specific details on maintainers, community channels (like Discord/Slack), or roadmaps are provided in the README.

Licensing & Compatibility

The README does not specify the license type or compatibility notes for commercial use.

Limitations & Caveats

Host implementation is external (MCP-UI repo) or requires custom development by clients. The current version ^0.0.1 indicates potential early-stage development and possible breaking changes.