# mcp-ui: Building Interactive UIs for AI with Model Context Protocol

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/idosal-mcp-ui
Generated for open source discovery and AI-assisted research.

mcp-ui is an SDK that enables the creation of rich, interactive user interfaces for AI tools, built on the Model Context Protocol (MCP). It standardizes UI delivery over the protocol, allowing developers to craft next-gen UI experiences. This project provides client and server SDKs in multiple languages, making it easier to integrate dynamic UIs into AI applications.

GitHub: https://github.com/idosal/mcp-ui
OSRepos URL: https://osrepos.com/repo/idosal-mcp-ui

## Summary

mcp-ui is an SDK that enables the creation of rich, interactive user interfaces for AI tools, built on the Model Context Protocol (MCP). It standardizes UI delivery over the protocol, allowing developers to craft next-gen UI experiences. This project provides client and server SDKs in multiple languages, making it easier to integrate dynamic UIs into AI applications.

## Topics

- ai
- frontend
- llm
- mcp
- ui
- web
- typescript
- sdk

## Repository Information

Last analyzed by OSRepos: Mon Mar 02 2026 20:06:09 GMT+0000 (Western European Standard Time)
Detail views: 6
GitHub clicks: 10

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

mcp-ui pioneered the concept of interactive UI over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction){target="_blank"}, enabling rich web interfaces for AI tools. This SDK implements the [MCP Apps standard](https://github.com/modelcontextprotocol/ext-apps){target="_blank"}, which standardizes UI delivery over the protocol. It allows developers to create dynamic UI resources that can be rendered by MCP Apps Hosts, significantly enhancing user interaction with AI agents.

The project offers `@mcp-ui/server` and `@mcp-ui/client` for TypeScript, alongside server SDKs for Ruby (`mcp_ui_server`) and Python (`mcp-ui-server`). These tools empower developers to build next-generation UI experiences that seamlessly integrate with the MCP ecosystem.

## Installation

Getting started with `mcp-ui` is straightforward, with SDKs available for multiple programming languages.

### TypeScript

Install the client and server packages using your preferred package manager:

bash
npm install @mcp-ui/server @mcp-ui/client

# or pnpm
pnpm add @mcp-ui/server @mcp-ui/client

# or yarn
yarn add @mcp-ui/server @mcp-ui/client


### Ruby

Install the Ruby server gem:

bash
gem install mcp_ui_server


### Python

Install the Python server package:

bash
pip install mcp-ui-server

# or uv
uv add mcp-ui-server


## Examples

`mcp-ui` provides a variety of examples to help you understand its capabilities and integrate it into your projects.

### Client Examples

*   [Goose](https://github.com/block/goose){target="_blank"}: An open-source AI agent that supports `mcp-ui`.
*   [LibreChat](https://github.com/danny-avila/LibreChat){target="_blank"}: An enhanced ChatGPT clone with `mcp-ui` support.
*   [ui-inspector](https://github.com/idosal/ui-inspector){target="_blank"}: A tool to inspect local `mcp-ui`-enabled servers.
*   [MCP-UI Chat](https://github.com/idosal/scira-mcp-ui-chat){target="_blank"}: An interactive chat application built with the `mcp-ui` client.

### Server Examples

*   [TypeScript Server Demo](https://github.com/MCP-UI-Org/mcp-ui/tree/main/examples/typescript-server-demo){target="_blank"}: A simple TypeScript server demonstrating how to generate UI resources.
*   [Ruby Server Demo](https://github.com/MCP-UI-Org/mcp-ui/tree/main/examples/ruby-server-demo){target="_blank"}: A barebones demo server showcasing the use of `mcp_ui_server` and `mcp` gems.
*   [Python Server Demo](https://github.com/MCP-UI-Org/mcp-ui/tree/main/examples/python-server-demo){target="_blank"}: A simple demo server illustrating the use of the `mcp-ui-server` Python package.

## Why Use mcp-ui?

`mcp-ui` offers compelling advantages for developers looking to enhance their AI applications with rich user interfaces:

*   **Interactive AI Experiences:** Transform static AI responses into dynamic, interactive user interfaces, significantly enhancing user engagement and utility.
*   **Standardized UI Delivery:** Leverage the MCP Apps specification for consistent UI integration across various AI hosts, ensuring broad compatibility.
*   **Multi-language Support:** Develop UI resources using TypeScript, Ruby, or Python, catering to diverse development environments and preferences.
*   **Broad Host Compatibility:** `@mcp-ui` supports both modern MCP Apps hosts and legacy MCP-UI hosts, with specialized adapters available for platforms like ChatGPT, ensuring your UIs work where they are needed.
*   **Robust Security:** All remote code is executed within sandboxed iframes, prioritizing host and user security by isolating UI content.
*   **Extensible Architecture:** The SDK supports various content types, including HTML and remote-DOM, and is designed for future expansion with component libraries and declarative UI, providing a future-proof solution.

## Links

Explore `mcp-ui` further through its official channels:

*   **GitHub Repository:** [https://github.com/MCP-UI-Org/mcp-ui](https://github.com/MCP-UI-Org/mcp-ui){target="_blank"}
*   **Official Documentation:** [https://mcpui.dev](https://mcpui.dev){target="_blank"}
*   **Discord Community:** [https://discord.gg/CEAG4KW7ZH](https://discord.gg/CEAG4KW7ZH){target="_blank"}