Terminal Controller MCP Server

Was macht der “Terminal Controller” MCP Server?

Der Terminal Controller MCP Server ist ein Model Context Protocol (MCP) Server, der die sichere Ausführung von Terminal-Befehlen, Verzeichnisnavigation und Dateisystemoperationen über eine standardisierte Schnittstelle ermöglicht. Er fungiert als Brücke zwischen KI-Assistenten und der Host-Umgebung, sodass KI-Agenten Aufgaben wie das Ausführen von Shell-Befehlen, die Verwaltung von Verzeichnissen und das Bearbeiten von Dateien programmatisch durchführen können. Mit integrierten Sicherheitsmechanismen, Protokollierung der Befehls-Historie und plattformübergreifender Kompatibilität verbessert Terminal Controller Entwicklungsworkflows, indem KI-gestützten Tools kontrollierter Zugriff auf Terminal und Dateisystem eines Rechners gewährt wird. Diese Fähigkeit befähigt KI-Assistenten, systemnahe Aufgaben für Entwickler sicher und standardisiert zu automatisieren, zu erkunden und zu verwalten.

Liste der Prompts

Keine Prompt-Vorlagen wurden im Repository oder in der Dokumentation gefunden.

Liste der Ressourcen

Keine expliziten MCP-Ressourcen wurden im Repository oder der Dokumentation definiert.

Liste der Tools

• Befehlsausführung: Ermöglicht das Ausführen von Terminalbefehlen mit Timeout-Steuerung und umfassender Ausgabeerfassung.
• Verzeichnisverwaltung: Erlaubt das Navigieren und Auflisten von Verzeichnissen mit intuitiver Formatierung.
• Dateioperationen: Unterstützt das Lesen, Schreiben, Aktualisieren, Einfügen und Löschen von Dateiinhalten mit Zeilenpräzision.
• Befehlshistorie: Verfolgt und zeigt ausgeführte Befehle zur Auditierung und Wiederholbarkeit an.

Anwendungsfälle dieses MCP Servers

• Automatisierte Befehlsausführung: Entwickler können KI-Assistenten anweisen, Shell-Befehle sicher zum Bauen, Testen oder Deployen von Code auszuführen, wobei Ausgaben und Fehler erfasst werden.
• Verzeichnis- und Dateiverwaltung: KI-Agenten können bei der Organisation, Durchsicht oder Bearbeitung von Dateien und Ordnern helfen, wodurch die Automatisierung der Codebase-Erkundung oder der Umgebungseinrichtung erleichtert wird.
• Sicherheitsbewusstes Scripting: Integrierte Schutzmechanismen helfen, gefährliche Befehle zu verhindern und das Risiko beim Terminalzugriff für KI zu minimieren.
• System-Monitoring und Auditierung: Die Befehlshistorie ermöglicht das Nachverfolgen ausgeführter Aktionen und unterstützt Audits sowie Workflow-Transparenz.
• Plattformübergreifende Entwicklung: Dank Unterstützung von Windows- und UNIX-basierten Systemen sorgt der MCP-Server für konsistente Entwicklungserfahrungen in unterschiedlichen Umgebungen.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Python 3.11+ installiert ist.
2. Installieren Sie das Paket über PyPI:

   pip install terminal-controller
   

3. Bearbeiten Sie Ihre Windsurf-Konfigurationsdatei und fügen Sie den MCP-Server hinzu:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Speichern Sie die Konfiguration und starten Sie Windsurf neu.
5. Überprüfen Sie, ob der MCP-Server läuft und erreichbar ist.

Claude

1. Installieren Sie Python 3.11+ auf Ihrem Rechner.
2. Für Claude Desktop Installation via Smithery:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Alternativ Installation via PyPI:

   pip install terminal-controller
   

4. Fügen Sie Folgendes zu Ihrer Claude-Konfiguration hinzu:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Starten Sie Claude Desktop neu und stellen Sie sicher, dass der MCP-Server erkannt wird.

Cursor

1. Stellen Sie sicher, dass Node.js und Python 3.11+ installiert sind.
2. Installieren Sie terminal-controller:

   pip install terminal-controller
   

3. Fügen Sie den MCP-Server zu Ihrer Cursor-Konfiguration hinzu:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Speichern Sie die Datei und starten Sie Cursor neu.
5. Überprüfen Sie die Integration, indem Sie die Tool-Liste in Cursor prüfen.

Cline

1. Stellen Sie sicher, dass Python 3.11+ verfügbar ist.
2. Installieren Sie den MCP-Server:

   pip install terminal-controller
   

3. Fügen Sie den folgenden Abschnitt zu Ihrer Cline-Konfiguration hinzu:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Starten Sie Cline nach dem Speichern neu.
5. Testen Sie die Schnittstelle, indem Sie einen einfachen Befehl über das MCP-Interface ausführen.

API-Schlüssel absichern

Wenn API-Schlüssel oder Geheimnisse für Ihr Setup benötigt werden, verwenden Sie Umgebungsvariablen anstelle von Hard-Coding. Beispielkonfiguration:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

Verwendung dieses MCP in Flows

Verwendung von MCP in FlowHunt

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie sie mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. In der System-MCP-Konfiguration fügen Sie Ihre MCP-Serverdaten in folgendem JSON-Format ein:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent dieses MCP als Tool mit allen Funktionen und Fähigkeiten nutzen. Denken Sie daran, “terminal-controller” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL mit Ihrer eigenen MCP-Server-URL anzugeben.

Übersicht

Basierend auf den obigen Informationen bietet der Terminal Controller MCP essenziellen Terminal- und Dateisystemzugriff auf sichere Weise, es fehlen jedoch Prompt-Vorlagen und explizite Ressourcen. Die Konfiguration ist gut dokumentiert und plattformübergreifend. Roots und Sampling werden nicht erwähnt. Insgesamt ist dies ein praxisnaher, sicherer, aber relativ einfacher Server für DevOps- oder Automatisierungs-Kernaufgaben.

MCP-Score