mmartinrm97/terminalize

Was macht terminalize?

MCP-Server, der KI-Agenten ein interaktives Terminal mit vollständiger PTY-Unterstützung bietet — Tastenanschläge senden, Ausgaben lesen, auf Eingabeaufforderungen warten und Vordergrundprozesse steuern. Wird mit einem Setup-Assistenten und installierbaren Agenten-Fähigkeiten ausgeliefert.

Funktionen

• Interaktives Terminal mit PTY-Unterstützung
• Tastenanschläge senden: Geben Sie Befehle oder Text ein, als ob ein Benutzer tippt.
• Ausgabe lesen: Lesen Sie die aktuelle Terminalausgabe (zeilenweise oder komplett).
• Auf Eingabeaufforderungen warten: Warten Sie, bis ein bestimmtes Muster in der Ausgabe erscheint.
• Vordergrundprozesse steuern: Starten, stoppen und verwalten Sie Prozesse im Terminal.
• Setup-Assistent: Einfache Erstkonfiguration.
• Installierbare Agenten-Fähigkeiten: Vorgefertigte Skills für verschiedene KI-Plattformen.

Voraussetzungen

• Node.js 18 oder höher
• Ein MCP-kompatibler Client (z. B. Claude Code, Cursor, Codex)

Installation

npm install -g @mmartinrm97/terminalize

Oder mit dem Setup-Assistenten:

npx @mmartinrm97/terminalize setup

Konfiguration

Fügen Sie die folgende Konfiguration zu Ihrem MCP-Client hinzu (z. B. mcp.json):

{
  "mcpServers": {
    "terminalize": {
      "command": "npx",
      "args": ["@mmartinrm97/terminalize"]
    }
  }
}

Verwendung

Agenten-Fähigkeit installieren

touch ~/.claude/skills/terminalize

Beispiel-Prompt für den Agenten

Öffne ein Terminal und führe npm init aus. Warte auf die erste Eingabeaufforderung und sende dann my-project als Projektnamen. Überspringe die restlichen Fragen mit Enter.

API-Referenz

Werkzeuge:

• terminal_execute – Führt einen Befehl im Terminal aus und gibt die Ausgabe zurück.
• terminal_send_keys – Sendet Tastenanschläge an das Terminal.
• terminal_read_output – Liest die aktuelle Terminalausgabe.
• terminal_wait_for – Wartet auf ein bestimmtes Muster in der Ausgabe.
• terminal_control_process – Steuert einen Vordergrundprozess (z. B. SIGINT senden).

Ressourcen:

• terminal://session – Informationen zur aktuellen Terminalsitzung.

Lizenz

MIT