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). 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)

npx mcporter list
npx mcporter list linear --schema

Instalação global

npm install -g mcporter
# ou Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter

Exemplos de chamadas

# 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.

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.

mcporter