Repolode
Enviar
MCP-UI-Org

MCP-UI-Org/mcp-ui

SDKs de TypeScript, Ruby y Python para crear interfaces interactivas que las herramientas MCP pueden devolver y los hosts pueden renderizar.

Ver en GitHubSitio web
Estrellas
5,224
Forks
434
Issues abiertos
64
Último commit
el mes pasado

¿Qué es?

mcp-ui es un SDK para añadir interfaces de usuario interactivas a las herramientas expuestas mediante el Model Context Protocol (MCP). Un servidor crea un recurso de interfaz, normalmente HTML disponible en una URI `ui://`, y un host MCP lo obtiene y lo renderiza junto al resultado de la herramienta, para que el asistente de IA pueda mostrar widgets en lugar de solo texto.

El proyecto implementa el patrón MCP Apps, en el que una herramienta enlaza con su interfaz mediante `_meta.ui.resourceUri`, y también admite un enfoque heredado que inserta recursos de interfaz directamente en las respuestas de las herramientas. Los paquetes de cliente incluyen los componentes `AppRenderer` y `UIResourceRenderer`, además de un Web Component. El contenido de la interfaz se ejecuta en un iframe aislado, y los widgets pueden llamar a herramientas o enviar mensajes al host mediante `onUIAction` y otros handlers relacionados.

Hay helpers para el servidor disponibles en TypeScript (`@mcp-ui/server`), Ruby (`mcp_ui_server`) y Python (`mcp-ui-server`). El proyecto también incluye un adaptador de Apps SDK para traducir su protocolo `postMessage` a la API `window.openai` de ChatGPT.

Funciones clave

  • 01Crea recursos de interfaz con URI `ui://` y tipo MIME `text/html` para hosts MCP
  • 02Enlaza herramientas con interfaces mediante `_meta.ui.resourceUri`, siguiendo el patrón MCP Apps
  • 03Ofrece los componentes React `AppRenderer` y `UIResourceRenderer`, además de un Web Component
  • 04Renderiza el contenido de la interfaz en iframes aislados
  • 05Incluye SDKs de servidor para TypeScript, Ruby y Python
  • 06Incluye un adaptador que conecta con el ChatGPT Apps SDK

Casos de uso

  • Añadir un formulario o widget de panel a un servidor MCP para que lo muestre un asistente de IA
  • Crear un host MCP que renderice interfaces de herramientas de servidores de terceros
  • Devolver controles interactivos que llamen a herramientas cuando el usuario haga clic en ellos
  • Integrar widgets basados en MCP en un backend de Ruby o Python

Inicio rápido

  1. 1

    Instala los paquetes de servidor y cliente de TypeScript con npm

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

    O instala el SDK de servidor de Python con pip

    pip install mcp-ui-server
  3. 3

    Crea un recurso de UI y vincula una herramienta a él mediante _meta.ui.resourceUri, siguiendo el ejemplo de Getting Started

Antes de usarlo

  • Para renderizar, se necesita un host compatible con MCP Apps o con el renderer heredado de MCP-UI.
  • AppRenderer necesita una URL de sandbox proxy configurada para poder mostrar las UI.
  • Algunos adaptadores específicos de cada host se ofrecen como puente y podrían dejar de ser necesarios cuando los hosts adopten la especificación abierta.

Temas

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

Preguntas frecuentes

¿Qué es mcp-ui?
SDKs de TypeScript, Ruby y Python para crear interfaces interactivas que las herramientas MCP pueden devolver y los hosts pueden renderizar. mcp-ui es un SDK para añadir interfaces de usuario interactivas a las herramientas expuestas mediante el Model Context Protocol (MCP). Un servidor crea un recurso de interfaz, normalmente HTML disponible en una URI `ui://`, y un host MCP lo obtiene y lo renderiza junto al resultado de la herramienta, para que el asistente de IA pueda mostrar widgets en lugar de solo texto.
¿mcp-ui es gratuito? ¿Qué licencia tiene?
mcp-ui es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-ui sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de mcp-ui fue el 16 sept 2026.
¿Para qué puedo usar mcp-ui?
Añadir un formulario o widget de panel a un servidor MCP para que lo muestre un asistente de IA Crear un host MCP que renderice interfaces de herramientas de servidores de terceros Devolver controles interactivos que llamen a herramientas cuando el usuario haga clic en ellos Integrar widgets basados en MCP en un backend de Ruby o Python
¿Cómo se instala mcp-ui?
Instala los paquetes de servidor y cliente de TypeScript con npm: npm install @mcp-ui/server @mcp-ui/client O instala el SDK de servidor de Python con pip: pip install mcp-ui-server Crea un recurso de UI y vincula una herramienta a él mediante _meta.ui.resourceUri, siguiendo el ejemplo de Getting Started
¿Dónde consigo mcp-ui?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/MCP-UI-Org/mcp-ui

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados