Terminal — Claude Desktop-Erweiterung für Linux

Eine Claude Desktop-Erweiterung, die Claude Zugriff auf Terminal, Dateisystem und Hintergrundprozesse auf Ihrem lokalen Linux-Rechner gewährt.

Sie schließt eine Lücke in der Linux-Version von Claude Desktop, bei der MCP-Server im Stil von claude_desktop_config.json nicht geladen werden (dieser Mechanismus ist nur unter macOS/Windows verfügbar); unter Linux ist der einzige Weg, Tools hinzuzufügen, die Verwendung installierbarer Erweiterungen.

⚠️ Sicherheit — bitte zuerst lesen

Die Installation dieser Erweiterung gewährt Claude uneingeschränkten Shell-Zugriff auf Ihr Benutzerkonto. Alles, was Sie von einem Terminal aus tun können, kann Claude über dieses Tool ebenfalls tun: jede Datei lesen, auf die Ihr Benutzer Zugriff hat, alles ändern, was Sie ändern können, Software installieren, Netzwerkverbindungen öffnen usw.

Betrachten Sie die Installation so, als würden Sie jemandem eine SSH-Sitzung auf Ihrem Rechner geben. Installieren Sie es nicht auf Rechnern mit sensiblen Daten, die Claude nicht sehen soll, oder auf gemeinsam genutzten Systemen.

Es gibt eine minimale integrierte Sicherheits-Denylist, die eine Handvoll offensichtlich destruktiver Einzeiler ablehnt (rm -rf /, rm -rf ~, Fork-Bomben, dd/mkfs auf rohen Laufwerken, shutdown/reboot). Dies ist ein Sicherheitsnetz für den Notfall, keine Sandbox. Ein entschlossener Befehl kann es mühelos umgehen. Es existiert lediglich, damit ein Moment der Unaufmerksamkeit nicht Ihr Home-Verzeichnis löscht.

Um die Einschränkungen zu verschärfen, bearbeiten Sie das DENYLIST-Array am Anfang von server.js und erstellen Sie das Projekt neu. Um sie vollständig zu entfernen, setzen Sie DENYLIST = [] und erstellen Sie es neu.

Related MCP server: claude-linux-mcp

Funktionsweise

Stellt Claude 8 Tools zur Verfügung:

Der Laufzeitstatus (Transkripte, temporäre Job-Dateien) befindet sich unter /tmp/claude-term-mcp/ und wird beim Neustart gelöscht.

Installation

1. Laden Sie die neueste Terminal.mcpb von der Releases-Seite herunter.

2. Öffnen Sie Claude Desktop → Settings → Extensions.

3. Scrollen Sie zum Abschnitt Extension Developer am unteren Rand. Klicken Sie auf Install Extension und wählen Sie die heruntergeladene Terminal.mcpb-Datei aus.

4. Claude Desktop zeigt die Erweiterungsdetails mit einer roten Warnung "developer info not verified by Anthropic" an. Überprüfen Sie, ob Sie der Quelle vertrauen, und klicken Sie dann auf Install.

5. Bei der Installation fragt Claude Desktop nach einem Default working directory — dies ist das Verzeichnis, in dem Shell-Befehle ausgeführt werden, wenn Claude keines angibt. Wählen Sie Ihren Hauptprojektordner oder lassen Sie es leer, um standardmäßig Ihr Home-Verzeichnis zu verwenden.

6. Stellen Sie unter All extensions sicher, dass Terminal aktiviert ist.

7. Öffnen Sie in einem Chat die Auswahl für Konnektoren/Tools und aktivieren Sie Terminal für diese Unterhaltung.

Sie können das Standard-Arbeitsverzeichnis später unter Settings → Extensions → Terminal ändern.

Anforderungen

• Claude Desktop ≥ 0.10.0 unter Linux (auch unter macOS getestet)

• Node.js ≥ 16 (Claude Desktop bündelt eine aktuelle Node-Version, die es zum Ausführen der Erweiterung verwendet, daher ist kein systemweites Node erforderlich)

• bash im PATH

Kein npm install-Schritt erforderlich — die Erweiterung ist reines Node ohne Abhängigkeiten.

Konfiguration

Die gesamte Konfiguration erfolgt über die Benutzeroberfläche von Claude Desktop bei der Installation oder unter Settings → Extensions → Terminal.

Um die Denylist oder anderes Verhalten anzupassen, bearbeiten Sie server.js und erstellen Sie das Projekt neu (siehe unten).

Bekannte Probleme

Gelbes Banner: "Tool result could not be submitted. The request may have expired or the connection was interrupted." Dies erscheint bei jedem Schritt, der Claudes dynamisches Tool-Laden auslöst. Der 404-Fehler bezieht sich auf die Übermittlung des Tool-Suchergebnisses an das Anthropic-Backend, nicht auf das MCP-Tool selbst — Ihr Tool-Aufruf wird ausgeführt und gibt unmittelbar nach dem Banner korrekt Ergebnisse zurück. Es ist rein kosmetisch. Dasselbe Problem tritt auch bei der mitgelieferten Filesystem-Erweiterung auf. Wahrscheinlich ein Protokoll-Mismatch zwischen Client und Backend, der in einer zukünftigen Version von Claude Desktop behoben wird.

Aus Quellcode erstellen

git clone https://github.com/LukeLamb/claude-terminal-mcp
cd claude-terminal-mcp

# Edit whatever you want in server.js / manifest.json.
# If you change the tool surface, update both places.

# Bump the version in manifest.json so Claude Desktop treats the install as an update.

# Build the bundle:
zip -j Terminal.mcpb manifest.json package.json server.js

# Then install Terminal.mcpb via Claude Desktop → Settings → Extensions → Install Extension.

Deinstallation

Settings → Extensions → All extensions → Terminal → Remove.

Datenschutzrichtlinie

Keine Daten verlassen Ihren Rechner. Diese Erweiterung läuft vollständig lokal:

• Datenerfassung: Keine. Die Erweiterung telefoniert nicht nach Hause, sendet keine Telemetrie und führt keine eigenen Netzwerkanfragen durch. Alle Netzwerkaufrufe, die Sie beobachten, sind solche, die Sie Claude ausführen lassen (z. B. curl, wget, git push).

• Datennutzung & Speicherung: Befehls-Transkripte (stdin ausgeschlossen, stdout + stderr + Exit-Code) werden unter /tmp/claude-term-mcp/runs/<timestamp>.log geschrieben, damit Claude später in derselben Unterhaltung darauf verweisen kann. Der Status von Hintergrundprozessen (Befehl, PID, stdout/stderr-Logdateien, Exit-Code, Status) wird unter /tmp/claude-term-mcp/jobs/<job-id>/ gespeichert.

• Weitergabe an Dritte: Keine. Nichts wird von dieser Erweiterung an Anthropic, den Autor der Erweiterung oder Dritte übertragen. (Claude Desktop selbst sendet Tool-Ein- und Ausgaben separat als Teil des normalen Chat-Ablaufs an Anthropic — das ist die Beziehung zwischen Ihnen und Anthropic, nicht die dieser Erweiterung.)

• Aufbewahrung: /tmp/claude-term-mcp/ wird bei jedem Neustart gelöscht. Um es manuell zu löschen: rm -rf /tmp/claude-term-mcp.

• Berechtigungsumfang: Befehle werden mit den Berechtigungen Ihres eigenen Benutzers ausgeführt — genau so, als würden Sie sie in ein Terminal eingeben.

• Kontakt / Fragen: Erstellen Sie ein Issue unter https://github.com/LukeLamb/claude-terminal-mcp/issues.

Lizenz

MIT. Frei verwendbar, Namensnennung geschätzt, keine Gewährleistung.