# mcporter

MCPorter es un entorno de ejecución en TypeScript, una CLI y un kit de herramientas de generación de código para el Model Context Protocol (MCP). Descubre, llama y convierte cualquier servidor MCP en una CLI independiente o una API tipada con descubrimiento de configuración cero.

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

Language: es

Category: Tools & Extensions

Updated: 2026-04-06

## 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)](https://github.com/modelcontextprotocol/specification). 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)
```bash
npx mcporter list
npx mcporter list linear --schema
```

### Instalación global
```bash
npm install -g mcporter
# o Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter
```

### Ejemplos de llamadas
```bash
# 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
```bash
mcporter generate-cli --command https://mcp.context7.com/mcp
```

### Uso en 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();
```

Documentación completa, referencia de la CLI y ejemplos en el [repositorio](https://github.com/steipete/mcporter).

## ¿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](https://github.com/steipete/mcporter)
- Sitio web: [mcporter.dev](https://mcporter.dev)
- Referencia de la CLI y Documentación: [github.com/steipete/mcporter/tree/main/docs](https://github.com/steipete/mcporter/tree/main/docs)

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

## Tags

- mcp
- typescript
- cli
- cliente-mcp
- agente-ia
- llamada-herramientas
- generación-código
- runtime
- claude
- cursor
- context7

## Sources

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