dsh-cordis-mcp

Das dynamische Cordis-Werkzeugset von DeepSeek Harness wird über MCP (Streamable HTTP) für Claude Code freigegeben: Claude Code kann DSH-dynamische Plugins in Echtzeit laden, definieren, ausführen, aktualisieren, stoppen, löschen – genau dieselben Fähigkeiten und derselbe Laufzeit-Agent, wie wenn du in einer DSH-Session cordis_define / cordis_run / cordis_stop / cordis_undefine / cordis_inspect_* verwendest.

┌─────────────┐   MCP (Streamable HTTP, loopback)   ┌───────────────────────────┐
│ Claude Code │ ────── http://127.0.0.1:8090/mcp ──▶ │ DSH host (本插件)           │
│  (claude)   │ ────── JSON-RPC 2.0 ───────────────▶ │  dynamicCordisRunner      │
└─────────────┘                                       │  cordisInspect            │
                                                      │  agents (会话解析)         │
                                                      └───────────────────────────┘

Das Plugin hängt am vorhandenen Web-Port, öffnet keinen neuen Port und veröffentlicht keinen Dienst; der MCP-Endpunkt erzwingt die Bearer-Authentifizierung. Das Token wird auf der Seite DSH-Einstellungen → dsh-cordis-mcp konfiguriert (beim ersten Mal automatisch generiert, kann angepasst/neu generiert werden).

Fähigkeiten (10 Tools)

Pakete mit Client-Hälfte durchlaufen beim ersten Start weiterhin den Genehmigungsprozess von DSH: dsh_plugin_run gibt awaiting-approval zurück. Nachdem du auf der Run-Karte im DSH-Web-GUI „Erlauben“ geklickt hast, wird asynchron abgeschlossen – genau wie in einer DSH-Session.

Related MCP server: engine

Ein-Klick-Installation

curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-cordis-mcp/main/install.sh | bash

Was das Skript tut (mit --dry-run vorab anzusehen):

1. Schreibt die Abhängigkeit "dsh-cordis-mcp": "github:GeekRicardo/dsh-cordis-mcp" in ~/.dsh/profiles/web/package.json;

2. Fügt dsh-cordis-mcp zu dsh.profile.bundles hinzu;

3. cd ~/.dsh/profiles/web && pnpm install;

4. Prüft, dass die Bundles registriert sind, und weist auf einen Neustart hin.

Nach einem Neustart von DSH und einem Hard-Refresh der Seite ist der MCP-Endpunkt zusammen mit dem Web-Dienst bereit:

pm2 restart dsh-web   # 若用 pm2 托管；否则用你的启动方式重启

Anbindung an Claude Code

# 端口换成你 DSH web 的实际端口（启动日志会打印完整地址）
claude mcp add dsh --transport http http://127.0.0.1:8090/mcp
claude mcp list          # 确认 connected

Authentifizierung (erzwungen, keine direkte Verbindung)

Der MCP-Endpunkt erzwingt die Bearer-Authentifizierung: Ohne Token wird immer 401 zurückgegeben (falls kein Token konfiguriert ist: 503). Das Token wird auf der Seite DSH-Einstellungen → dsh-cordis-mcp konfiguriert: Beim ersten Gebrauch automatisch generiert und persistent gespeichert; die Seite ermöglicht das Anzeigen/Kopieren/Anpassen/Neugenerieren. Trage das Token in den Request-Header von .mcp.json ein:

{
  "mcpServers": {
    "dsh": {
      "type": "http",
      "url": "http://127.0.0.1:8090/mcp",
      "headers": { "Authorization": "Bearer <设置页里的 token>" }
    }
  }
}

Token-Auflösungspriorität: Konfiguration der Einstellungsseite > DSH_MCP_TOKEN-Umgebungsvariable > automatisch generiert. Ein geändertes Token wird sofort wirksam (kein Neustart nötig); nach der Neugenerierung verliert das alte Token sofort seine Gültigkeit und die Claude-Code-Konfiguration muss entsprechend aktualisiert werden.

Session-Semantik (wichtig)

Dynamische Plugins sind Sessions zugeordnet und liegen im Prozessspeicher (werden beim DSH-Neustart geleert). Die Session-Auflösung der Brücke erfolgt in dieser Reihenfolge:

1. sessionId aus den Aufrufparametern (über dsh_sessions abfragbar);

2. festgelegt durch die Umgebungsvariable DSH_MCP_DEFAULT_SESSION;

3. die aktuell einzige aktive Session;

4. mehrere aktive Sessions ohne Angabe → Fehler mit Auflistung der Optionen; das Übergeben von sessionId ist erforderlich.

Weitere Umgebungsvariablen

Sicherheitsgrenzen

• Erzwungene Bearer-Authentifizierung: Ohne Token immer 401 bzw. 503, wenn kein Token konfiguriert ist; der Endpunkt kann nie direkt verbunden werden;

• akzeptiert nur Loopback-Hosts (127.* / localhost / ::1) und lehnt jeglichen externen Zugriff ab;

• lehnt Browseranfragen mit sec-fetch-site: cross-site ab und gibt niemals CORS-Header zurück – Webseiten können die Antwort nicht lesen;

• die Route der Einstellungsseite /dsh-cordis-mcp/settings erlaubt nur Same-Origin-Loopback (ohne MCP-Token; geändert wird nur die Token-Konfiguration selbst);

• der Endpunkt kann Plugins definieren/ausführen/löschen – entspricht Shell-Berechtigungen. Setze den Port nicht für andere als lokale Geräte frei.

Funktionsweise

Deinstallation

# 1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除 "dsh-cordis-mcp"
# 2. 移除 dependencies 里的 "dsh-cordis-mcp"
# 3. cd ~/.dsh/profiles/web && pnpm install
# 4. 重启 DSH；claude mcp remove dsh

Voraussetzungen

• DeepSeek Harness hat ein Web-Profil initialisiert (~/.dsh/profiles/web existiert), und die aktuelle Session läuft auf einem Preset mit dem Cordis-Toolset (der Host-Dienst dynamicCordisRunner existiert; standardmäßig vorhanden);

• die Claude-Code-CLI ist auf diesem Rechner installiert und angemeldet;

• Node.js ≥ 20 und pnpm sind verfügbar.

Fehlerbehebung

Lizenz

MIT