dsh-mcp-manager
dsh-mcp-manager

Haltbarer MCP-Server-Manager für DeepSeek Harness (DSH) – ein zusammengesetztes Loader-Plugin (kein dynamisches Session-Plugin), das DSH-Neustarts und Upgrades überlebt.
Entwickelt nach dem DSH-Plugin-Entwicklungsstandard (siehe offizielle Dokumentation: 第一个插件, 开发一个工具):
Objektform-Cordis-Plugin (
export default { name, inject, apply })erforderliche Dienste in
injectdeklariert – das Framework garantiert, dass sie bereit sind, bevorapplyausgeführt wird, und lädt das Plugin neu, wenn einer verschwindet (dadurch bleibt das Plugin über DSH-Upgrades hinweg aktiv)agentenseitige Fähigkeiten, die als registrierte Modellwerkzeuge via
ctx.tools.register(defineTool(...))bereitgestellt werden:mcp_manager_list,mcp_manager_set_enabled,mcp_manager_restart,mcp_manager_addUI-seitige Fähigkeit über eine exakte
webServer-Route (POST /dsh-mcp-manager/api), die von der Client-Hälfte genutzt wird
Funktionen:
Einstellungen → MCP Verwaltung-Seite (von der Client-Hälfte hinzugefügt)
Die Host-Hälfte verwaltet die
@deepseek-ai/dsh-mcp-client-Zeilen in den tatsächlichen Patch-Dateien:Projektebene →
~/.dsh/profiles/<profile>/cordis.patch.ymlGlobal →
~/.dsh/cordis.patch.ymlHinzufügen / Bearbeiten / Aktivieren / Deaktivieren / Neustarten / Löschen, Live-Tool-Anzahl-Gesundheit, JSON-Export/Import, Schreibsperre pro Datei
Funktionsweise
Teil | Datei | Rolle |
Host-Plugin-Quellcode |
| TypeScript-Quellcode (die dokumentierte Plugin-Form); mit |
Host-Plugin (kompiliert) |
| Cordis-Objektform-Plugin: Patch-Datei CRUD + 4 Modellwerkzeuge + |
Client-Bundle |
| Browser-Modul: registriert die Einstellungsseite; ruft den Host via |
Loader-Zeile | zur | setzt den Host-Eintrag zusammen; das Client-Module-Service scannt aktivierte Einträge und stellt das Client-Bundle bereit |
Der Loader-Eintrag ist der einzige Zusammensetzungspunkt für beide Hälften – keine Änderungen an einem ausgelieferten DSH-Paket. Das Paket selbst ist plattformneutral (reines JS; Pfadtrennzeichen werden zur Laufzeit erkannt), daher funktioniert es unter Windows, macOS und Linux. Das Bauen (npm run build) erfordert die devDependencies (typescript, @deepseek-ai/cordis, @deepseek-ai/dsh-tools, @types/node); das ausgelieferte/installierte Paket benötigt keine davon.
Related MCP server: mcp-serverman
Installation (beliebige Plattform)
Schnellste – ein Befehl, via npm (erfordert Node.js >= 18):
# Option A — one-shot with npx, nothing to install
npx -y @xxxyz/dsh-mcp-manager
# Option B — global npm install, then run the command any time
npm i -g @xxxyz/dsh-mcp-manager
dsh-mcp-manager # install the plugin
dsh-mcp-manager-uninstall # uninstall the plugin
npm i -g @xxxyz/dsh-mcp-manager@latest # upgradeAlle Flags werden in beiden Optionen durchgereicht: npx -y @xxxyz/dsh-mcp-manager --dsh-home /path/.dsh --profile web --repair --port 3080.
npm-Paketname:
@xxxyz/dsh-mcp-manager(der bloße Namedsh-mcp-managerist auf npm von einem nicht verwandten Paket belegt). Der bereitgestellte Plugin-Name ist weiterhindsh-mcp-manager– npm/npx ist nur der Lieferkanal; das Installationsprogramm kopiert die Dateien an dieselben festgelegten Speicherorte unten.
No-npm-Alternative – direkt von GitHub:
npx -y github:xxxyz/DeepSeekHarness-MCP-ManagerAlternative – Installationsskripte aus einem Quell-Checkout ausführen (alle Installationsprogramme teilen eine plattformübergreifende Logikdatei, install.mjs). Installationsschritte:
Kopieren Sie das Paket nach
<dshHome>/local-packages/dsh-mcp-manager(eine echte Quelle außerhalb vonnode_modules, sodass DSH-Upgrades sie nie berühren)Kopieren Sie es in
<dshHome>/profiles/node_modules/dsh-mcp-manager(absichtlich eine einfache Kopie – ein Symlink würde dazu führen, dass Node ESM den realpath des Plugins auflöst, wo@deepseek-ai/dsh-toolsnicht gefunden werden kann)Fügen Sie die Loader-Zeile an
profiles/<profile>/cordis.patch.ymlan (idempotent; hält den Patch als gültiges Top-Level-Array)
Windows (PowerShell):
.\dsh-mcp-manager\install.ps1 # default: ~/.dsh, web profile
# or: .\install.ps1 -DshHome D:\path\.dsh -Profile webmacOS / Linux:
./dsh-mcp-manager/install.sh # default: ~/.dsh, web profile
# or: ./install.sh --dsh-home /path/.dsh --profile webBeliebige Plattform (direkt):
node dsh-mcp-manager/install.mjs [--dsh-home <path>] [--profile <name>] [--port <n>] [--repair] [--skip-patch]Starten Sie dann DSH neu und öffnen Sie Einstellungen → MCP Verwaltung. Die vier mcp_manager_*-Werkzeuge sind nach diesem Neustart für das Modell aufrufbar.
Deinstallation (beliebige Methode):
dsh-mcp-manager-uninstall # if installed via npm -g
# or: .\dsh-mcp-manager\uninstall.ps1 | ./uninstall.sh | node uninstall.mjs [--dsh-home <path>] [--profile <name>]Dann starten Sie DSH neu. Die Deinstallation entfernt die bereitgestellte Kopie, die local-packages-Quelle und die Loader-Zeile.
Nach einem DSH-Upgrade: --repair
Ein DSH-Upgrade (oder ein defekter HMR-Zustand) kann dazu führen, dass die Host-Hälfte des Plugins entladen wird, während die Dateien noch vorhanden sind. Ein Befehl behebt das – kopiert das Paket erneut aus der Quell-Paketverwaltung, erhöht die config.version der Loader-Zeile, um ein erneutes Anwenden von HMR zu erzwingen, und fragt dann die API ab, bis sie antwortet:
node dsh-mcp-manager/install.mjs --repair # default ~/.dsh, web, port 3080
node dsh-mcp-manager/install.mjs --repair --port 3080
# PowerShell: .\install.ps1 -Repair -Port 3080 bash: ./install.sh --repair --port 3080--repair gibt nur dann Erfolg zurück, wenn POST /dsh-mcp-manager/api wieder mit {ok:true} antwortet. Wenn die API nach 30s immer noch nicht antwortet, starten Sie DSH einmal neu (der Loader importiert beim Boot immer neu).
API-Referenz
Alle Operationen sind POST /dsh-mcp-manager/api mit {"op": "<op>", "args": {...}}, gleicher Ursprung.
op | args | Ergebnis | |
|
|
| |
| |||
`{serverName, transport, url | command, args?, headers?, env?, level, enabled?} | ||
` |
| ||
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
| |
|
|
|
Modellwerkzeuge
Auf dem Host registriert mit ctx.tools.register(defineTool(...)) (Standard @deepseek-ai/dsh-tools):
Werkzeug | Beschreibung | |
| Alle konfigurierten MCP-Server auflisten (Ebene, Aktivierungsstatus, Live-Loader-Status, Werkzeuganzahl) | |
| Einen Server aktivieren/deaktivieren (id, level, enabled) | |
| Einen Server neu starten (id, level) | |
| Einen Server hinzufügen (serverName, transport, url | command, …, level) |
Hinweise / Einschränkungen
Die HTTP-Route ist auf dem lokalen Webserver nicht authentifiziert – für einen lokalen Einzelbenutzerrechner in Ordnung; setzen Sie den DSH-Web-Port nicht öffentlich aus.
Verwaltete Zeilen tragen
# dsh-mcp-manager:server:<id>-Markierungen; die Loader-Zeile ist eininsert-Block, derid: mcp-manager, name: dsh-mcp-managerhinzufügt – DSHs Patch-Dialekt behandelt eine einfache- id:-Zeile als Überschreibung eines vorhandenen Eintrags (stillschweigend übersprungen, wenn nicht vorhanden), daher erfordert das Hinzufügen eines Plugins dieinsert-Form.Wenn die laufende Webseite älter als die Installation ist, ist ein Seitenrefresh oder ein DSH-Neustart erforderlich, damit das Client-Modul funktioniert (der Boot-Graph wird beim Seitenladen erstellt).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
MCP server for AI dialogue using various LLM models via AceDataCloud
A MCP server built for developers enabling Git based project management with project and personal…
Cloud-hosted MCP server for durable AI memory
Related MCP Servers
- AlicenseAqualityDmaintenanceA robust MCP server with tools to search, install, configure, repair, and uninstall MCP servers, automating setup and maintenance across multiple AI and developer tools.417MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to manage MCP server configurations, including listing, enabling, disabling, and version control.10MIT
- AlicenseNot gradedqualityCmaintenanceMCP management panel for DeepSeek Harness, enabling connection status monitoring, one-click upgrades, and server addition via a settings UI.1MIT
- AlicenseAqualityDmaintenanceMCP server wrapping DeepSeek's agent harness tools into minimal/standard modes, enabling persistent shell, file editing, search, job management, and more via natural language.2MIT