Resumen

mcporter (MCPorter 🧳) es un runtime TypeScript de código abierto, CLI y kit de herramientas de generación de código para el Model Context Protocol (MCP). Permite a desarrolladores y agentes de IA descubrir servidores MCP configurados, llamar herramientas directamente, componer automatizaciones en TypeScript y generar CLIs de un solo propósito desde cualquier endpoint MCP.

Creado para apoyar la guía de Anthropic "Ejecución de Código con MCP", elimina código repetitivo y la inflación de la ventana de contexto al permitir que los agentes de IA invoquen herramientas a través de binarios CLI livianos en lugar de cargar esquemas JSON masivos.

Última versión: 0.8.2 (Marzo de 2026). Licencia MIT.

Características

• Descubrimiento sin Configuración: Encuentra automáticamente servidores MCP desde ~/.mcporter/mcporter.json, configuraciones de proyectos e integraciones con Claude, Cursor, Codex, VS Code, Windsurf y OpenCode.
• Llamada a Herramientas Orientada a CLI: Ejecuta herramientas con sintaxis natural (mcporter call linear.create_comment ...) o estilo de llamada a función — sin necesidad de conocer el esquema.
• Generación CLI de un Comando: mcporter generate-cli crea CLIs independientes y autocontenidos (Bun/Node) desde cualquier servidor MCP para facilitar su uso y distribución por agentes.
• API TypeScript Tipada: mcporter emit-ts genera interfaces .d.ts o wrappers de cliente completos con tipado fuerte, valores por defecto y validación.
• Runtime Componible: createRuntime() + createServerProxy() con agrupación de conexiones, caché de OAuth, seguimiento de registros (log tailing) y soporte para transportes HTTP/SSE/stdio.
• Modo Ad-Hoc y Daemon: Conéctate instantáneamente a cualquier endpoint MCP; mantén servidores con estado (por ejemplo, chrome-devtools) activos con comandos daemon.
• Amigable para Agentes de IA: Reduce la inflación del contexto — los agentes llaman a un pequeño binario CLI en lugar de incrustar esquemas MCP completos.
• Herramientas Robustas: Autocorrección, formateo de salida enriquecido (text(), json()), gestión de configuración y ayudas de depuración.

Casos de Uso

• Integración de Herramientas para Agentes de IA: Permite que Claude/Cursor llame a servidores MCP complejos a través de CLIs generados sin hacer estallar las ventanas de contexto.
• Scripting Rápido de Automatización: Construye flujos de trabajo en TypeScript que componen múltiples herramientas MCP con total seguridad de tipos.
• Compartir Herramientas: Genera y distribuye CLIs de un solo propósito (por ejemplo, linear-comment) para equipos o uso público.
• Desarrollo y Depuración: Inspecciona instantáneamente el esquema de cualquier servidor MCP o llama herramientas ad-hoc durante la creación de prototipos.
• Reducción de la Inflación MCP: Reemplaza la carga pesada de esquemas en editores/agentes con llamadas CLI livianas.

Instalación y Inicio Rápido

Ejecutar instantáneamente (sin instalación)

npx mcporter list
npx mcporter list linear --schema

Instalación global

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

Ejemplos de llamadas

# Sintaxis con dos puntos
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# Sintaxis estilo llamada a función
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'

Generar una CLI

mcporter generate-cli --command https://mcp.context7.com/mcp

Uso en TypeScript

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();

Documentación completa, referencia de la CLI y ejemplos en el repositorio.

¿Por qué mcporter?

MCP da superpoderes a los agentes de IA a través de herramientas, pero gestionar esquemas y conexiones es engorroso. mcporter hace que MCP sea ergonómico — descubre una vez, llama al instante, genera CLIs para agentes y escribe código limpio y tipado. La navaja suiza definitiva para MCP.

Enlaces

• GitHub: steipete/mcporter
• Sitio web: mcporter.dev
• Referencia de la CLI y Documentación: github.com/steipete/mcporter/tree/main/docs

El compañero perfecto para cualquier flujo de trabajo de IA impulsado por MCP.