mcp-use

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.

Prévia da interface de mcp-use

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

  1. Gere um projeto com um único comando, npx create-mcp-use-app my-app, ou instale o pacote Python com pip install mcp-use
  2. Defina suas ferramentas, recursos e prompts num arquivo de servidor e rode em local com npm run dev
  3. Abra o Inspector embutido para testar chamadas de ferramentas e ler o tráfego JSON-RPC sem um modelo ativo
  4. Conecte um repositório à Manufact Cloud e faça push, ou rode mcp-use deploy pela 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.

Plano gratuitoSim
Planos pagos$0 - $1,000+/mo
PlataformaWeb, Node.js, Python, CLI, ChatGPT, Claude, Gemini, Cursor
DesenvolvedorManufact
CategoriaProgramação
Data de lançamentoJan 2025
Última atualizaçãoOct 2025
Visitas ao site7K
Ranking global do site3.2M
Disponibilidade da APISim

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.