
mcp-use
Manufact · Programação
mcp-use é um framework open source para criar servidores, clientes e agentes de IA com Model Context Protocol em TypeScript e Python, com hospedagem opcional na Manufact Cloud.

Sobre mcp-use
What Is mcp-use
mcp-use é um framework de código aberto para quem desenvolve com Model Context Protocol, o padrão que deixa modelos de IA conversarem com ferramentas e dados externos. Ele cobre três peças num mesmo stack: servidores MCP, clientes MCP e agentes de IA. Você escreve em TypeScript ou Python, e o framework cuida da parte do protocolo para que você foque no que a ferramenta faz.
O projeto nasceu do time que hoje se chama Manufact, e o SDK é o núcleo open source dele. Desde 2026 a empresa mantém uma plataforma de hospedagem combinada, a Manufact Cloud, que faz o deploy do que você cria com mcp-use. Com um push no GitHub o servidor entra no ar, sem brigar com YAML nem Dockerfile.
A promessa é velocidade, e os exemplos de código sustentam isso. O projeto diz que dá para levantar servidores, clientes e agentes MCP em cerca de seis linhas de código por peça. Quem já montou o SDK oficial na mão sabe quanto código repetitivo isso poupa.
Vale conhecer dois limites antes de começar. O serviço hospedado é um produto pago à parte, então o plano gratuito do mcp-use cobre só a biblioteca open source. E o framework aposta primeiro no TypeScript, o que o deixa muito confortável para times web e um pouco mais pesado para quem trabalha só com Python e quer os recursos de interface mais completos.
Getting Started
- Gere um projeto com um único comando,
npx create-mcp-use-app my-app, ou instale o pacote Python compip install mcp-use - Defina suas ferramentas, recursos e prompts num arquivo de servidor e rode em local com
npm run dev - Abra o Inspector embutido para testar chamadas de ferramentas e ler o tráfego JSON-RPC sem um modelo ativo
- Conecte um repositório à Manufact Cloud e faça push, ou rode
mcp-use deploypela CLI, para publicar seu servidor no ChatGPT, no Claude e em outros clientes
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de mcp-use.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores backend e fullstack
- Times de produto de IA
- Contribuidores de código aberto e curiosos
- Líderes técnicos de startups
Tarefas
- Criar servidores MCP
- Conectar clientes MCP
- Construir agentes de IA
- Depurar tráfego MCP
- Hospedar e fazer deploy
Cenários
- Um time quer expor uma ferramenta interna ao Claude
- Lançar um app para o ChatGPT
- Prototipar um agente
- Adicionar ferramentas a um chatbot que já existe
- Publicar um servidor aberto
Principais recursos
Stack MCP Fullstack em TypeScript e Python
O mcp-use cobre a cadeia toda: servidores, clientes e agentes, tanto em TypeScript quanto em Python. Você não precisa misturar bibliotecas para ter algo funcionando, e as duas linguagens compartilham conceitos e nomes. O time chama isso de framework fullstack, e dessa vez o rótulo encaixa, porque um mesmo projeto toca o que você constrói e o que o chama.
Estrutura Pronta com um Comando
Rodar npx create-mcp-use-app my-app gera um projeto funcionando com o servidor, uma camada de interface em React e um servidor de desenvolvimento já ligados. A ideia é pular o dia de configuração que costuma vir antes da primeira chamada de ferramenta. No Python, um simples pip install mcp-use entrega o framework de servidor sozinho.
Inspector Embutido e Testes Locais
O framework traz um Inspector web que roda seu servidor contra clientes reais. Você dispara chamadas de ferramentas, lê o JSON-RPC cru e troca de modelo, GPT, Claude ou Gemini, para comparar o comportamento. Dá para depurar pelo navegador sem montar nada em local, o que importa quando o erro só aparece com um modelo específico.
MCP-UI e Widgets de App Interativos
Além dos servidores, o mcp-use cria MCP Apps: widgets em React que aparecem dentro do ChatGPT e do Claude como interfaces de verdade, não como texto. O framework dá suporte de primeira linha a esses recursos de interface, então você constrói um app interativo e ele roda em vários ambientes. É essa função que separa o mcp-use das bibliotecas MCP de baixo nível.
APIs de Cliente e de Agente
O lado cliente liga qualquer LLM a qualquer servidor MCP e deixa você chamar ferramentas direto quando não precisa de um agente. O lado agente soma raciocínio entre passos, uso de ferramentas, navegação na web e manejo de arquivos. Os dois fazem parte do mesmo pacote, então sair de um cliente programado para um agente completo não significa aprender um segundo framework.
Hospedagem e Deploy na Manufact Cloud
A plataforma de hospedagem ligada ao projeto transforma um repositório num servidor rodando. Você conecta o GitHub uma vez e cada push faz deploy sozinho, com URL de pré-visualização por branch, domínios próprios e SSL incluído. Um painel acompanha requisições, builds, testes e logs de execução, então as operações ficam num lugar só.
Compatibilidade com o SDK Oficial e Documentação
O framework de servidor estende o SDK oficial do MCP em vez de substituí-lo, então os servidores que você já tem migram sem quebrar e seguem dentro da especificação. Ele soma endpoints de documentação, registro estruturado e um arquivo de metadados openmcp.json para descoberta. Essa mistura mantém você compatível com o ecossistema MCP mais amplo enquanto acrescenta as peças de produção.
Prós e contras
Prós
- É open source e gratuito para usar, então você adota sem ligação de vendas nem taxa de licença
- Um único framework cobre servidores, clientes e agentes tanto em TypeScript quanto em Python
- O Inspector embutido deixa você testar chamadas de ferramentas e JSON-RPC sem um modelo ativo
- O suporte a MCP-UI permite apps interativos para ChatGPT e Claude, não só ferramentas de texto
- Continua compatível com o SDK oficial do MCP, então seus servidores atuais são portados sem reescrever
Contras
- A hospedagem fica numa plataforma paga à parte, então o plano gratuito do SDK não inclui destino de deploy
- O framework aposta primeiro no TypeScript, o que torna os recursos de interface mais completos um trabalho mais pesado para times só de Python
- O projeto mudou de nome de mcp-use para Manufact, então tutoriais antigos e referências de pacote podem apontar para nomes desatualizados
- As ferramentas mais maduras presumem um fluxo de Node e npm, o que adiciona atrito para times padronizados em outros ambientes
Perguntas frequentes
mcp-use é um framework open source para criar servidores, clientes e agentes de IA que usam Model Context Protocol. Funciona em TypeScript e Python e cuida dos detalhes do protocolo para que os desenvolvedores foquem nas ferramentas que expõem. O projeto hoje faz parte da Manufact.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a mcp-use.
Alternativas a mcp-use
Base Code
Base44 (Wix) · Programação · ProdutividadeO Base Code é um ambiente de desenvolvimento em nuvem compartilhado da Base44. O time descreve mudanças em um repositório do GitHub pelo chat, confere tudo na prévia e envia o resultado como pull request.
Google EmbeddingGemma 2
Google DeepMind · Escrita · Imagem · ProgramaçãoGoogle EmbeddingGemma 2 é um modelo aberto de 740 milhões de parâmetros que transforma texto, código, imagens, áudio e quadros de vídeo em vetores de um único espaço de 768 dimensões, rodando em celulares e notebooks.
GitGlow
GitGlow · Programação · ProdutividadeO GitGlow é um cliente Git de desktop que coloca seu código e as mudanças dos seus agentes de IA na mesma revisão, para você saber o que vai sair da máquina antes de publicar.
