Supports running the MCP server on Linux platforms, enabling OS-level interactions like notifications and command-line prompts
Supports macOS-specific optimizations with Terminal.app profile settings for improved window management when the MCP server starts and stops
Provides a Model Context Protocol server that runs locally alongside MCP clients, with direct access to the user's operating system for notifications and interactive prompts
Ein in Node.js/TypeScript implementierter MCP-Server, der die interaktive Kommunikation zwischen LLMs und Benutzern ermöglicht. Hinweis: Dieser Server ist für den lokalen Betrieb neben dem MCP-Client (z. B. Claude Desktop, VS Code) konzipiert, da er direkten Zugriff auf das Betriebssystem des Benutzers benötigt, um Benachrichtigungen und Eingabeaufforderungen anzuzeigen.
(Hinweis: Dieses Projekt befindet sich noch in der Anfangsphase.)
Möchten Sie einen schnellen Überblick? Lesen Sie den einführenden Blogbeitrag: Stoppen Sie das Raten Ihres KI-Assistenten – Einführung in interactive-mcp
| Demo-Video |
|---|
Dieser Server stellt die folgenden Tools über das Model Context Protocol (MCP) bereit:
request_user_input : Stellt dem Benutzer eine Frage und gibt dessen Antwort zurück. Kann vordefinierte Optionen anzeigen.message_complete_notification : Sendet eine einfache Betriebssystembenachrichtigung.start_intensive_chat : Startet eine dauerhafte Befehlszeilen-Chatsitzung.ask_intensive_chat : Stellt eine Frage während einer aktiven intensiven Chat-Sitzung.stop_intensive_chat : Schließt eine aktive intensive Chatsitzung.Hier sind Demonstrationen der interaktiven Funktionen:
| Normale Frage | Abschlussbenachrichtigung |
|---|---|
| Intensiver Chat-Start | Intensives Chat-Ende |
|---|---|
Dieser Server eignet sich ideal für Szenarien, in denen ein LLM direkt mit dem Benutzer auf dessen lokalem Computer interagieren muss, beispielsweise:
In diesem Abschnitt wird erläutert, wie MCP-Clients für die Verwendung des interactive-mcp -Servers konfiguriert werden.
Standardmäßig werden Benutzeraufforderungen nach 30 Sekunden abgebrochen. Sie können Serveroptionen wie Timeout oder deaktivierte Tools anpassen, indem Sie bei der Konfiguration Ihres Clients Kommandozeilen-Flags direkt zum Array args hinzufügen.
Bitte stellen Sie sicher, dass Ihnen der Befehl npx zur Verfügung steht.
Fügen Sie die folgende minimale Konfiguration zu Ihrer claude_desktop_config.json (Claude Desktop) oder mcp.json (Cursor) hinzu:
Beispiel mit benutzerdefiniertem Timeout (30 s):
Fügen Sie Ihrer Benutzereinstellungsdatei (JSON) oder .vscode/mcp.json die folgende minimale Konfiguration hinzu:
Für ein reibungsloseres Erlebnis unter macOS mit der Terminal.app sollten Sie diese Profileinstellung berücksichtigen:
Dieser Abschnitt richtet sich in erster Linie an Entwickler, die den Server ändern oder ergänzen möchten. Wenn Sie den Server nur mit einem MCP-Client verwenden möchten, lesen Sie den Abschnitt „Client-Konfiguration“ weiter oben.
package.json auf Versionskompatibilität.npm install -g pnpm nach der Installation von Node.js.Der interactive-mcp -Server akzeptiert die folgenden Befehlszeilenoptionen. Diese sollten typischerweise in den JSON-Einstellungen Ihres MCP-Clients konfiguriert werden, indem sie direkt zum Array args hinzugefügt werden (siehe Beispiele „Client-Konfiguration“).
| Option | Alias | Beschreibung |
|---|---|---|
--timeout | -t | Legt das Standard-Timeout (in Sekunden) für Benutzereingabeaufforderungen fest. Der Standardwert beträgt 30 Sekunden. |
--disable-tools | -d | Deaktiviert bestimmte Tools oder Gruppen (komma-getrennte Liste). Verhindert, dass der Server diese ankündigt oder registriert. Optionen: request_user_input , message_complete_notification , intensive_chat . |
Beispiel: Festlegen mehrerer Optionen im Array „Client- args :
pnpm buildpnpm lintpnpm formatBeachten Sie bei der Interaktion mit diesem MCP-Server (z. B. als LLM-Client) die folgenden Grundsätze, um Übersichtlichkeit zu gewährleisten und unerwartete Änderungen zu vermeiden:
request_user_input , start_intensive_chat usw.) häufig, um mit dem Benutzer zu interagieren.Sie können einem LLM-Client diese Anweisungen wie folgt bereitstellen:
Beiträge sind willkommen! Bitte befolgen Sie die üblichen Entwicklungspraktiken. (Weitere Details können später hinzugefügt werden.)
MIT (Einzelheiten finden Sie in der Datei LICENSE – falls zutreffend, oder geben Sie die Lizenz direkt an).
You must be authenticated.
Ein Node.js/TypeScript MCP-Server, der die interaktive Kommunikation zwischen LLMs und Benutzern erleichtert und es KI-Assistenten ermöglicht, Benutzereingaben anzufordern, Benachrichtigungen anzuzeigen und Chatsitzungen über die Befehlszeile zu verwalten.