mcporter

Übersicht

mcporter (MCPorter 🧳) ist eine quelloffene TypeScript-Laufzeitumgebung, CLI und Code-Generierungs-Toolbox für das Model Context Protocol (MCP). Es ermöglicht Entwicklern und KI-Agenten, konfigurierte MCP-Server zu entdecken, Tools direkt aufzurufen, Automatisierungen in TypeScript zu erstellen und zielgerichtete CLIs von jedem MCP-Endpunkt zu generieren.

Entwickelt, um die Richtlinien von Anthropic für "Code Execution with MCP" zu unterstützen, eliminiert es Standard-Code und reduziert die Kontextfenster-Belastung, indem KI-Agenten Tools über schlanke CLI-Binärdateien aufrufen können, anstatt massive JSON-Schemata zu laden.

Aktuelle Version: 0.8.2 (März 2026). MIT lizenziert.

Funktionen

• Zero-Config-Erkennung: Findet MCP-Server automatisch aus ~/.mcporter/mcporter.json, Projektkonfigurationen und Integrationen mit Claude, Cursor, Codex, VS Code, Windsurf und OpenCode.
• CLI-First-Tool-Aufrufe: Tools mit natürlicher Syntax ausführen (mcporter call linear.create_comment ...) oder im Funktionsaufruf-Stil — kein Schema-Wissen erforderlich.
• Ein-Kommando-CLI-Generierung: mcporter generate-cli erstellt eigenständige, eigenbündige CLIs (Bun/Node) von jedem MCP-Server für einfache Weitergabe und Agenten-Nutzung.
• Typisierte TypeScript-API: mcporter emit-ts generiert .d.ts-Schnittstellen oder vollständige Client-Wrapper mit starker Typisierung, Standardwerten und Validierung.
• Komponierbare Laufzeitumgebung: createRuntime() + createServerProxy() mit Verbindungspooling, OAuth-Caching, Log-Tailing und Unterstützung für HTTP/SSE/stdio-Transports.
• Ad-Hoc- & Daemon-Modus: Verbinde dich sofort mit jedem MCP-Endpunkt; halte statusbehaftete Server (z.B. chrome-devtools) mit Daemon-Befehlen warm.
• KI-Agenten-freundlich: Reduziert die Kontext-Belastung — Agenten rufen eine kleine CLI-Binärdatei auf, anstatt vollständige MCP-Schemata einzubetten.
• Robuste Tooling: Auto-Korrektur, umfangreiche Ausgabeformatierung (text(), json()), Konfigurationsverwaltung und Debug-Helper.

Anwendungsfälle

• KI-Agenten-Tool-Integration: Ermögliche Claude/Cursor, komplexe MCP-Server über generierte CLIs aufzurufen, ohne die Kontextfenster zu überlasten.
• Schnelle Automatisierungs-Skripterstellung: Erstelle TypeScript-Workflows, die mehrere MCP-Tools mit voller Typsicherheit kombinieren.
• Tool-Sharing: Generiere und verteile zielgerichtete CLIs (z.B. linear-comment) für Teams oder die öffentliche Nutzung.
• Entwicklung & Debugging: Inspiziere sofort jedes MCP-Server-Schema oder rufe Tools ad-hoc während der Prototypen-Entwicklung auf.
• Reduzierung von MCP-Overhead: Ersetze das schwere Schema-Laden in Editoren/Agenten durch schlanke CLI-Aufrufe.

Installation & Schnellstart

Sofort ausführen (keine Installation)

npx mcporter list
npx mcporter list linear --schema

Globale Installation

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

Beispielaufrufe

# Doppelpunktsyntax
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# Funktionsaufruf-Syntax
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'

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

TypeScript-Nutzung

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

Vollständige Dokumentation, CLI-Referenz und Beispiele im Repository.

Warum mcporter?

MCP gibt KI-Agenten Superkräfte durch Tools, aber die Verwaltung von Schemas und Verbindungen ist mühsam. mcporter macht MCP ergonomisch — einmal entdecken, sofort aufrufen, CLIs für Agenten generieren und sauberen typisierten Code schreiben. Das ultimative MCP-Schweizer Taschenmesser.

Links

• GitHub: steipete/mcporter
• Website: mcporter.dev
• CLI-Referenz & Dokumentation: github.com/steipete/mcporter/tree/main/docs

Perfekter Begleiter für jeden MCP-gestützten KI-Workflow.