Repolode
Предложить
MCP-UI-Org

MCP-UI-Org/mcp-ui

SDK на TypeScript, Ruby и Python для создания интерактивных UI-ресурсов, которые MCP-инструменты могут возвращать, а хосты — отображать.

Открыть на GitHubСайт
Звёзды
5,224
Форки
434
Открытые issues
64
Последний коммит
в прошлом месяце

Что это?

mcp-ui — SDK для добавления интерактивных пользовательских интерфейсов к инструментам, доступным через Model Context Protocol (MCP). Сервер создаёт UI-ресурс, обычно HTML-страницу по URI вида ui://, а MCP-хост получает и отображает её рядом с результатом работы инструмента. Так AI-ассистент может показывать виджеты, а не только текст.

Проект реализует паттерн MCP Apps: инструмент связывается со своим UI через _meta.ui.resourceUri. Также поддерживается устаревший подход, при котором UI-ресурсы встраиваются прямо в ответы инструментов. В клиентских пакетах доступны компоненты AppRenderer и UIResourceRenderer, а также Web Component. UI-контент работает в изолированном iframe, а виджеты могут вызывать инструменты или отправлять сообщения хосту через onUIAction и связанные обработчики.

Вспомогательные серверные инструменты доступны для TypeScript (@mcp-ui/server), Ruby (mcp_ui_server) и Python (mcp-ui-server). Проект также включает адаптер Apps SDK, который преобразует протокол postMessage в API window.openai в ChatGPT.

Ключевые возможности

  • 01Создаёт UI-ресурсы с URI ui:// и MIME-типом text/html для MCP-хостов
  • 02Связывает инструменты с UI через _meta.ui.resourceUri по паттерну MCP Apps
  • 03Предоставляет React-компоненты AppRenderer и UIResourceRenderer, а также Web Component
  • 04Отображает UI-контент в изолированных iframe
  • 05Поддерживает серверные SDK для TypeScript, Ruby и Python
  • 06Включает адаптер для интеграции с ChatGPT Apps SDK

Сценарии использования

  • Добавить форму или виджет панели мониторинга в MCP-сервер, чтобы AI-ассистент мог его отображать
  • Создать MCP-хост, который отображает UI инструментов сторонних серверов
  • Возвращать интерактивные элементы управления, вызывающие инструменты по нажатию пользователя
  • Интегрировать виджеты на базе MCP в бэкенд на Ruby или Python

Быстрый старт

  1. 1

    Установите пакеты сервера и клиента TypeScript с помощью npm

    npm install @mcp-ui/server @mcp-ui/client
  2. 2

    Или установите серверный SDK для Python с помощью pip

    pip install mcp-ui-server
  3. 3

    Создайте ресурс UI и свяжите с ним инструмент через _meta.ui.resourceUri, следуя примеру Getting Started

Что важно знать

  • Для рендеринга нужен хост с поддержкой MCP Apps или устаревшего renderer MCP-UI.
  • Чтобы отображать UI, для AppRenderer необходимо настроить URL sandbox proxy.
  • Некоторые адаптеры для конкретных хостов предоставляются в качестве моста и могут стать ненужными, когда хосты перейдут на открытую спецификацию.

Темы

#mcp#ai-agent#llm#ui-components#typescript#sdk#iframe#web-components#ai#frontend

Частые вопросы

Что такое mcp-ui?
SDK на TypeScript, Ruby и Python для создания интерактивных UI-ресурсов, которые MCP-инструменты могут возвращать, а хосты — отображать. mcp-ui — SDK для добавления интерактивных пользовательских интерфейсов к инструментам, доступным через Model Context Protocol (MCP). Сервер создаёт UI-ресурс, обычно HTML-страницу по URI вида ui://, а MCP-хост получает и отображает её рядом с результатом работы инструмента. Так AI-ассистент может показывать виджеты, а не только текст.
mcp-ui можно использовать бесплатно? Какая у него лицензия?
mcp-ui распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mcp-ui всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в mcp-ui — 16 сент. 2026 г..
Для чего можно использовать mcp-ui?
Добавить форму или виджет панели мониторинга в MCP-сервер, чтобы AI-ассистент мог его отображать Создать MCP-хост, который отображает UI инструментов сторонних серверов Возвращать интерактивные элементы управления, вызывающие инструменты по нажатию пользователя Интегрировать виджеты на базе MCP в бэкенд на Ruby или Python
Как установить mcp-ui?
Установите пакеты сервера и клиента TypeScript с помощью npm: npm install @mcp-ui/server @mcp-ui/client Или установите серверный SDK для Python с помощью pip: pip install mcp-ui-server Создайте ресурс UI и свяжите с ним инструмент через _meta.ui.resourceUri, следуя примеру Getting Started
Где скачать mcp-ui?
Исходный код и инструкции по установке — на GitHub: https://github.com/MCP-UI-Org/mcp-ui

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты