Repolode
Enviar
MCP-UI-Org

MCP-UI-Org/mcp-ui

SDKs em TypeScript, Ruby e Python para criar recursos de UI interativos que ferramentas MCP podem retornar e hosts podem renderizar.

Ver no GitHubSite
Estrelas
5,224
Forks
434
Issues abertas
64
Último commit
mês passado

O que é?

mcp-ui é um SDK para adicionar interfaces de usuário interativas às ferramentas disponibilizadas pelo Model Context Protocol (MCP). Um servidor cria um recurso de UI, geralmente HTML servido em uma URI ui://, e um host MCP o busca e renderiza junto ao resultado da ferramenta, permitindo que o assistente de IA exiba widgets em vez de apenas texto.

O projeto implementa o padrão MCP Apps, no qual uma ferramenta aponta para sua UI por meio de _meta.ui.resourceUri, e também oferece suporte a uma abordagem legada que incorpora recursos de UI diretamente nas respostas das ferramentas. Os pacotes de cliente fornecem os componentes AppRenderer e UIResourceRenderer, além de um Web Component. O conteúdo da UI é executado em um iframe isolado, e os widgets podem chamar ferramentas ou enviar mensagens de volta ao host por meio de onUIAction e handlers relacionados.

Há helpers no lado do servidor para TypeScript (@mcp-ui/server), Ruby (mcp_ui_server) e Python (mcp-ui-server). O projeto também inclui um adaptador do Apps SDK para traduzir seu protocolo postMessage para a API window.openai do ChatGPT.

Recursos principais

  • 01Cria recursos de UI com URIs ui:// e MIME type text/html para hosts MCP
  • 02Vincula ferramentas à UI por meio de _meta.ui.resourceUri usando o padrão MCP Apps
  • 03Oferece os componentes React AppRenderer e UIResourceRenderer, além de um Web Component
  • 04Renderiza conteúdo de UI em iframes isolados
  • 05Oferece SDKs de servidor para TypeScript, Ruby e Python
  • 06Inclui um adaptador que faz a ponte com o ChatGPT Apps SDK

Casos de uso

  • Adicionar um formulário ou widget de dashboard a um servidor MCP para que um assistente de IA possa exibi-lo
  • Criar um host MCP que renderiza UIs de ferramentas de servidores de terceiros
  • Retornar controles interativos que chamam ferramentas quando o usuário clica neles
  • Integrar widgets orientados por MCP a um backend em Ruby ou Python

Início rápido

  1. 1

    Instale os pacotes de servidor e cliente de TypeScript com npm

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

    Ou instale o SDK de servidor do Python com pip

    pip install mcp-ui-server
  3. 3

    Crie um recurso de UI e vincule uma ferramenta a ele usando _meta.ui.resourceUri, seguindo o exemplo de Getting Started

Antes de usar

  • A renderização requer um host compatível com MCP Apps ou com o renderer legado do MCP-UI.
  • O AppRenderer precisa de uma URL de sandbox proxy configurada para exibir as UIs.
  • Alguns adaptadores específicos de host são fornecidos como uma ponte e podem se tornar desnecessários à medida que os hosts adotarem a especificação aberta.

Tópicos

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

Perguntas frequentes

O que é mcp-ui?
SDKs em TypeScript, Ruby e Python para criar recursos de UI interativos que ferramentas MCP podem retornar e hosts podem renderizar. mcp-ui é um SDK para adicionar interfaces de usuário interativas às ferramentas disponibilizadas pelo Model Context Protocol (MCP). Um servidor cria um recurso de UI, geralmente HTML servido em uma URI ui://, e um host MCP o busca e renderiza junto ao resultado da ferramenta, permitindo que o assistente de IA exiba widgets em vez de apenas texto.
mcp-ui é gratuito? Qual é a licença?
mcp-ui é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-ui ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mcp-ui foi em 16 de set. de 2026.
Para que posso usar mcp-ui?
Adicionar um formulário ou widget de dashboard a um servidor MCP para que um assistente de IA possa exibi-lo Criar um host MCP que renderiza UIs de ferramentas de servidores de terceiros Retornar controles interativos que chamam ferramentas quando o usuário clica neles Integrar widgets orientados por MCP a um backend em Ruby ou Python
Como instalar mcp-ui?
Instale os pacotes de servidor e cliente de TypeScript com npm: npm install @mcp-ui/server @mcp-ui/client Ou instale o SDK de servidor do Python com pip: pip install mcp-ui-server Crie um recurso de UI e vincule uma ferramenta a ele usando _meta.ui.resourceUri, seguindo o exemplo de Getting Started
Onde consigo mcp-ui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MCP-UI-Org/mcp-ui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados