mcp-server-commands

Werkzeuge

Tools können von LLMs angefordert werden. Claude Sonnet 3.5 nutzt run_command intelligent. Erste Tests zeigen vielversprechende Ergebnisse mit Groq Desktop mit MCP- und llama4 -Modellen.

Derzeit reicht ein einziger Befehl, um sie alle zu steuern!

• run_command - führe einen Befehl aus, z. B. hostname oder ls -al oder echo "hello world" usw.
  • Gibt STDOUT und STDERR als Text zurück
  • Optionaler stdin -Parameter bedeutet, dass Ihr LLM
    • Passcode in stdin an Befehle wie fish , bash , zsh , python
    • Erstellen Sie Dateien mit cat >> foo/bar.txt aus dem Text in stdin

[!WARNUNG] Seien Sie vorsichtig, was Sie von diesem Server ausführen lassen! Verwenden Sie in der Claude Desktop-App „ Approve Once (nicht „ Allow for This Chat “), damit Sie jeden Befehl überprüfen können. Verwenden Sie Deny , wenn Sie dem Befehl nicht vertrauen. Die Berechtigungen werden vom Benutzer festgelegt, der den Server betreibt. Führen Sie den Befehl NICHT mit sudo aus.

Video-Komplettlösung

Eingabeaufforderungen

Eingabeaufforderungen dienen dazu, dass Benutzer sie in den Chatverlauf aufnehmen können, z. B. über Zed Schrägstrichbefehle (im AI-Chat-Bereich).

• run_command - generiert eine Eingabeaufforderung mit der Befehlsausgabe

Entwicklung

Installieren Sie Abhängigkeiten:

Erstellen Sie den Server:

Für die Entwicklung mit automatischem Rebuild:

Installation

Zur Verwendung mit Claude Desktop fügen Sie die Serverkonfiguration hinzu:

Unter MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Unter Windows: %APPDATA%/Claude/claude_desktop_config.json

Groq Desktop (Beta, macOS) verwendet ~/Library/Application Support/groq-desktop-app/settings.json

Verwenden Sie das veröffentlichte npm-Paket

Mit diesem Workflow als MCP-Server-Befehle auf npm veröffentlicht

Verwenden Sie einen lokalen Build (Repo-Checkout)

Stellen Sie sicher, dass Sie npm run build ausführen

Protokollierung

Die Claude Desktop-App schreibt Protokolle in ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log

Standardmäßig werden nur wichtige Meldungen (z. B. Fehler) protokolliert. Wenn Sie weitere Meldungen sehen möchten, fügen Sie bei der Serverkonfiguration den args --verbose hinzu.

Protokolle werden übrigens in STDERR geschrieben, da Claude Desktop dies an die Protokolldateien weiterleitet. Zukünftig erwarte ich, dass gut formatierte Protokollmeldungen über den STDIO -Transport an den MCP-Client (Hinweis: nicht an die Claude Desktop-App) geschrieben werden.

Debuggen

Da MCP-Server über stdio kommunizieren, kann das Debuggen eine Herausforderung darstellen. Wir empfehlen die Verwendung des MCP Inspector , der als Paketskript verfügbar ist:

Der Inspector stellt eine URL für den Zugriff auf Debugging-Tools in Ihrem Browser bereit.