dsh-mcphub

中文 | English

中文

MCP 管理パネル（DeepSeek Harness プラグイン）。設定パネルに MCP セクションを追加します：

• 接続ステータス：緑色の点＝そのサーバーのツールが現在のセッションに登録されています（AI が呼び出し可能）。灰色の点＝設定済みだがツールが未登録。トランスポートタイプ（stdio / HTTP）、ターゲットアドレス、ツール数とサンプルを表示します。

• アップグレード管理：pip でインストールされた stdio サーバー（例：scrapling）を自動検出し、PyPI の最新バージョンと比較して「アップグレード可能」バッジを表示、ワンクリックで pip install --upgrade を実行します（Windows のファイルロックを自動処理：占有プロセスを停止 + 古い exe を退避）。npx タイプのサーバーは npx キャッシュの実際のバージョンと比較し、「キャッシュをリフレッシュ」を提供。@latest タイプ（起動のたびに自動的に最新を取得）は重複して促しません。

• サーバー追加：フォームで serverName / transport / URL+headers または command+args+env を入力し、プロファイルの cordis.patch.yml に追記します（DSH 再起動後に有効）。

• 接続テスト：HTTP サーバーに実際の MCP initialize ハンドシェイクを送信します（serverInfo とレイテンシを表示）。stdio サーバーは実行ファイルの存在を検証します。

• 使用方法：ツール命名規則（mcp__<サーバー名>__<ツール名>）、AI による呼び出し方法、設定手動編集の例、シークレットキーに関する安全注意、トラブルシューティングガイド。

インストール

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

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

インストール後、DSH を再起動して有効にします。

プライバシー

設定ファイル内の headers / env キーは、プロービングのためホストメモリ内にのみ保持され、ブラウザには決して送信されません（パネルはキー名のみを受け取ります）。

よくある質問：プロファイルとは？

プロファイルは DSH の「独立した設定環境」です（ブラウザのマルチユーザープロファイルのようなもの）。各プロファイルは独自のプラグインと MCP リストを持ち、互いに影響しません。例：マシンに web（日常のウェブ版）と open-design（デザインソフトウェア用）の 2 セットを持たせ、それぞれに MCP を設定できます。追加フォームのプロファイル選択は、どの環境に書き込むかを決定します。プロファイルが 1 つだけの場合は考慮する必要はありません。

環境要件

• Node.js ≥ 20

• DeepSeek Harness（dsh-client-connection チャネルを含む、公式リリース版に同梱）

ステータスはどう計算されますか？

緑/灰色の点はプラグイン自身が維持するステータスではありません。プラグインは実行中のツールレジストリを読み取り、あるサーバーに mcp__<サーバー名>__* ツールの登録が存在すれば「接続済み」と見なします。利点は非侵入的で、常に実際の能力と一致すること。境界ケースとして「接続済みだが 0 個のツールを公開」の場合は灰色の点で表示されます。すべての設定変更（追加/一時停止/削除/アップグレード）は、DSH 再起動後に有効になります。

スクリーンショット

準備中：設定パネル → MCP セクションのスクリーンショット。

互換性

Windows / macOS / Linux で動作します（アップグレードアクションはプラットフォームごとに分岐：PowerShell ↔ pkill、where ↔ command -v、npm キャッシュパスの自動検出）。

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