dsh-mcphub

中文 | English

中文

MCP-Verwaltungspanel (DeepSeek Harness Plugin). Fügt im Einstellungsfeld einen MCP-Abschnitt hinzu:

• Verbindungsstatus: Grüner Punkt = Die Werkzeuge des Servers sind in der aktuellen Sitzung registriert (vom KI aufrufbar); grauer Punkt = Konfiguriert, aber keine Werkzeuge registriert. Zeigt Transporttyp (stdio / HTTP), Zieladresse, Anzahl der Werkzeuge und Beispiele an.

• Upgrade-Verwaltung: Erkennt automatisch per pip installierte stdio-Server (z. B. scrapling), vergleicht mit der neuesten PyPI-Version und zeigt ein „Upgrade verfügbar“-Abzeichen an. Ein-Klick-Ausführung von pip install --upgrade (automatische Windows-Dateisperrbehandlung: blockierende Prozesse stoppen + alte Exe sichern); npx-basierte Server vergleichen die tatsächliche Version im npx-Cache und bieten „Cache aktualisieren“; @latest-Typen (bei jedem Start automatisch die neueste Version holen) werden nicht wiederholt angezeigt.

• Server hinzufügen: Formular zur Eingabe von serverName / transport / URL+headers oder command+args+env, anhängend in cordis.patch.yml des Profils schreiben (wirksam nach Neustart von DSH).

• Konnektivitätstest: HTTP-Server senden echten MCP initialize-Handshake (zeigt serverInfo und Latenz); stdio-Server prüfen, ob die ausführbare Datei existiert.

• Anleitung: Werkzeugbenennungsregeln (mcp__<ServerName>__<Werkzeugname>), wie man das KI aufruft, manuelle Konfigurationsbeispiele, Sicherheitshinweise für Schlüssel, Fehlerbehebung.

Installation

# 从 GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub

# 或从 npm（如已发布）
dsh plugin --profile web add dsh-mcphub

Nach der Installation DSH neu starten, damit die Änderungen wirksam werden.

Datenschutz

Die Schlüssel in headers / env der Konfigurationsdatei werden nur im Host-Arbeitsspeicher für den Handshake verwendet und niemals an den Browser gesendet (das Panel erhält nur die Schlüsselnamen).

Häufige Frage: Was ist ein Profil?

Ein Profil ist eine isolierte Konfigurationsumgebung von DSH (ähnlich wie Browser-Mehrbenutzerprofile): Jedes Profil hat seine eigenen Plugins und MCP-Listen, die sich nicht gegenseitig beeinflussen. Beispiel: Auf einem Rechner können web (tägliche Webversion) und open-design (für Designsoftware) vorhanden sein, jeweils mit eigenen MCPs. Die Profilauswahl im Formular zum Hinzufügen bestimmt, in welche Umgebung geschrieben wird – bei nur einem Profil ist keine Auswahl nötig.

Systemvoraussetzungen

• Node.js ≥ 20

• DeepSeek Harness (enthält den dsh-client-connection-Kanal, in offiziellen Versionen enthalten)

Wie wird der Status berechnet?

Grüner/grauer Punkt wird nicht vom Plugin selbst verwaltet: Das Plugin liest die laufende Werkzeugregistrierung. Ein Server gilt als verbunden, wenn ein mcp__<ServerName>__*-Werkzeug registriert ist. Vorteil: keine Beeinflussung, immer konsistent mit den tatsächlichen Fähigkeiten; Grenzfall: „Verbunden, aber 0 Werkzeuge freigelegt“ wird als grauer Punkt angezeigt. Alle Konfigurationsänderungen (Hinzufügen/Anhalten/Löschen/Upgrade) werden nach einem Neustart von DSH wirksam.

Screenshots

Noch zu ergänzen: Screenshot des Einstellungsfelds → MCP-Abschnitt.

Kompatibilität

Windows / macOS / Linux werden unterstützt (Upgrade-Aktionen plattformabhängig: PowerShell ↔ pkill, where ↔ command -v, npm-Cache-Pfad automatisch erkannt).

English

MCP management panel for DeepSeek Harness. Adds an MCP section to the settings panel:

• Connection status: a green dot means the server's tools are registered in the live session (callable by the AI); grey means configured but not registered. Shows transport (stdio / HTTP), target, tool counts and samples.

• Upgrades: detects pip-installed stdio servers (e.g. scrapling), compares against PyPI, and upgrades in one click — including Windows file-lock handling (stop holders, park the old exe, restore on failure). npx-based servers are compared against the actual npx cache with a "refresh cache" action; @latest specs are never nagged (they self-update).

• Add servers: a form that appends proper cordis.patch.yml entries (serverName / transport / URL+headers or command+args+env). Takes effect after a DSH restart.

• Connectivity probe: HTTP servers get a real MCP initialize handshake (serverInfo + latency); stdio servers get an executable check.

• Help: tool naming (mcp__<server>__<tool>), how to invoke tools via the AI, manual config example, secret-safety notes, troubleshooting.

Install

# from GitHub
dsh plugin --profile web add github:jinhongxun/dsh-mcphub

# or from npm (once published)
dsh plugin --profile web add dsh-mcphub

Restart DSH after installing.

Privacy

Secrets in headers / env stay in the host process for probing only — they are never sent to the browser (the panel receives key names only).

FAQ: what is a profile?

A profile is DSH's isolated config environment (like browser profiles): each one keeps its own plugins and MCP server list. Example: a machine can have web (daily web UI) and open-design profiles, each with its own MCP servers. The profile picker in the add-server form decides which environment gets the new entry — with a single profile there is nothing to choose.

Requirements

• Node.js ≥ 20

• DeepSeek Harness (ships the dsh-client-connection channel in official builds)

Compatibility

Works on Windows / macOS / Linux (upgrade actions branch per platform: PowerShell ↔ pkill, where ↔ command -v, npm cache path auto-detected).

License

MIT