# mcporter

MCPorter é um runtime em TypeScript, uma CLI e um kit de ferramentas para geração de código para o Model Context Protocol (MCP). Descubra, chame e transforme qualquer servidor MCP em uma CLI autônoma ou API tipada com descoberta de configuração zero.

Canonical URL: https://a2a-mcp.org/entry/mcporter-pt

Language: pt

Category: Tools & Extensions

Updated: 2026-04-06

## Visão Geral

**mcporter** (MCPorter 🧳) é um **runtime em TypeScript, CLI e kit de ferramentas para geração de código** de código aberto para o [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/specification). Ele permite que desenvolvedores e agentes de IA descubram servidores MCP configurados, chamem ferramentas diretamente, componham automações em TypeScript e gerem CLIs de propósito único a partir de qualquer endpoint MCP.

Criado para apoiar a orientação "Execução de Código com MCP" da Anthropic, elimina código repetitivo e inchaço da janela de contexto, permitindo que agentes de IA invoquem ferramentas por meio de binários CLI leves em vez de carregar esquemas JSON massivos.

Última versão: **0.8.2** (Março de 2026). Licenciado sob MIT.

## Funcionalidades

- **Descoberta Sem Configuração**: Encontra automaticamente servidores MCP a partir de `~/.mcporter/mcporter.json`, configurações de projeto e integrações com Claude, Cursor, Codex, VS Code, Windsurf e OpenCode.
- **Chamada de Ferramentas Prioritária para CLI**: Execute ferramentas com sintaxe natural (`mcporter call linear.create_comment ...`) ou estilo de chamada de função — sem necessidade de conhecimento do esquema.
- **Geração de CLI por Único Comando**: `mcporter generate-cli` cria CLIs independentes e autocontidos (Bun/Node) a partir de qualquer servidor MCP para fácil compartilhamento e uso por agentes.
- **API TypeScript Tipada**: `mcporter emit-ts` gera interfaces `.d.ts` ou wrappers completos de cliente com tipagem forte, padrões e validação.
- **Runtime Composável**: `createRuntime()` + `createServerProxy()` com pooling de conexões, cache OAuth, rastreamento de logs e suporte para transportes HTTP/SSE/stdio.
- **Modo Ad-Hoc & Daemon**: Conecte-se instantaneamente a qualquer endpoint MCP; mantenha servidores com estado (por exemplo, chrome-devtools) ativos com comandos daemon.
- **Amigável para Agentes de IA**: Reduz o inchaço de contexto — agentes chamam um pequeno binário CLI em vez de incorporar esquemas MCP completos.
- **Ferramentas Robustas**: Correção automática, formatação rica de saída (`text()`, `json()`), gerenciamento de configuração e auxiliares de depuração.

## Casos de Uso

- **Integração de Ferramentas para Agentes de IA**: Permita que Claude/Cursor chamem servidores MCP complexos por meio de CLIs gerados sem explodir as janelas de contexto.
- **Scripting Rápido de Automação**: Crie fluxos de trabalho em TypeScript que combinem várias ferramentas MCP com total segurança de tipo.
- **Compartilhamento de Ferramentas**: Gere e distribua CLIs de propósito único (por exemplo, `linear-comment`) para equipes ou uso público.
- **Desenvolvimento & Depuração**: Inspecione instantaneamente o esquema de qualquer servidor MCP ou chame ferramentas ad-hoc durante a prototipagem.
- **Redução do Inchaço MCP**: Substitua o carregamento de esquemas pesados em editores/agentes por chamadas CLI leves.

## Instalação & Início Rápido

### Execute instantaneamente (sem instalação)
```bash
npx mcporter list
npx mcporter list linear --schema
```

### Instalação global
```bash
npm install -g mcporter
# ou Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter
```

### Exemplos de chamadas
```bash
# Sintaxe com dois pontos
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# Sintaxe de chamada de função
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'
```

# Gerar um CLI
mcporter generate-cli --command https://mcp.context7.com/mcp
```

### Uso com TypeScript
```ts
import { createRuntime } from "mcporter";
const runtime = await createRuntime();
const result = await runtime.callTool("context7", "resolve-library-id", {
  args: { libraryName: "react" }
});
console.log(result.text());
await runtime.close();
```

Documentação completa, referência do CLI e exemplos no [repositório](https://github.com/steipete/mcporter).

## Por que mcporter?

O MCP dá superpoderes a agentes de IA através de ferramentas, mas gerenciar schemas e conexões é trabalhoso. O mcporter torna o MCP *ergonômico* — descubra uma vez, chame instantaneamente, gere CLIs para agentes e escreva código limpo e tipado. A canivete suíço definitiva do MCP.

## Links

- GitHub: [steipete/mcporter](https://github.com/steipete/mcporter)
- Website: [mcporter.dev](https://mcporter.dev)
- Referência do CLI & Documentação: [github.com/steipete/mcporter/tree/main/docs](https://github.com/steipete/mcporter/tree/main/docs)

O companheiro perfeito para qualquer fluxo de trabalho de IA alimentado por MCP.

## Tags

- mcp
- typescript
- cli
- mcp-client
- agente-ia
- chamada-de-ferramentas
- geração-de-código
- runtime
- claude
- cursor
- context7

## Sources

- [Project website](https://github.com/steipete/mcporter)