dsh-mcp 1.0.0

package/CHANGELOG.en.md

@@ -0,0 +1,29 @@
+# Changelog
+
+**[简体中文](CHANGELOG.zh.md) | English**
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-08-15
+
+First stable release.
+
+### Added
+
+- **Managed MCP server registry** (host half, `lib/index.js`):
+  - Persistent server definitions (storage-domain `mcp_servers`)
+  - Per-server `@deepseek-ai/dsh-mcp-client` mounts; tools registered as `mcp__<serverName>__<tool>`
+  - Environment variable injection (plain values in the definition, secrets via the credentials document)
+  - Connection probe (`test`)
+- **Web settings page** (client half, `src/client/*`):
+  - Settings → MCP: server list / create / edit / delete / test connection
+  - Server-level enable/disable (tools unregister immediately when disabled)
+  - Per-server refresh button (re-pulls server status and tool list)
+- **Tool control**:
+  - Injection modes: `search` (on-demand, default — the model hot-injects tools via `mcp_tool_search`) and `full` (inject every enabled tool each request)
+  - Expandable per-server tool list, all checked by default; unchecking a tool keeps it out of injection, applied immediately
+- **Remote self-mount**: the client half mounts the `mcpManager` Remote namespace itself via `ctx.remote.$mount()` in `apply()`, so no in-box package modification is required
+- Zero npm runtime dependencies (`@deepseek-ai/*` resolve from the DSH profiles module fallback)

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# 更新日志（Changelog）
+
+**[English](CHANGELOG.en.md) | 简体中文**
+
+本项目的所有重要变更都会记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [1.0.0] - 2026-08-15
+
+首个正式版本。
+
+### 新增
+
+- **MCP 服务器托管**（host 半部，`lib/index.js`）：
+  - 持久化服务器注册表（storage-domain `mcp_servers`）
+  - 按服务器挂载 `@deepseek-ai/dsh-mcp-client` 实例，工具以 `mcp__<serverName>__<tool>` 注册
+  - 环境变量注入（明文入定义、secret 走凭据文档）
+  - 连接探测（test）
+- **Web 设置管理页**（client 半部，`src/client/*`）：
+  - Settings → MCP：服务器列表 / 新建 / 编辑 / 删除 / 测试连接
+  - 服务器级启用 / 禁用（禁用后工具即时注销）
+  - 每服务器刷新按钮（重新拉取服务器状态与工具列表）
+- **工具控制**：
+  - 注入模式：`search`（按需检索，默认，模型通过 `mcp_tool_search` 热注入）与 `full`（全量注入）
+  - 每服务器展开工具列表，默认全选，可取消勾选指定加载部分工具，立即生效
+- **Remote 自挂载**：client 半部在 `apply()` 内自行 `ctx.remote.$mount()` 挂载 `mcpManager` 命名空间，无需任何 in-box 包改动
+- 零 npm 运行时依赖（`@deepseek-ai/*` 从 DSH profiles 模块解析）

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arvin.qi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,106 @@
+# dsh-mcp — MCP server management plugin for DeepSeek Harness (standalone)
+
+![Settings preview](static/snapshot.webp)
+
+Migrated and merged from uncommitted MCP work in the `deepseek-harness` repository:
+
+| Original package | Migrated to |
+|---|---|
+| `packages/mcp/mcp-manager` (host registry) | `lib/index.js` (host half) |
+| `packages/client/ui-settings-mcp` (settings UI) | `src/client/*` → `lib/client.js` (browser half) |
+| `packages/bundle/web-mcp` (bundle assembly) | single row registered via `cordis.patch.yml` |
+| `packages/mcp/mcp-client/src/probe.ts` + `transport.ts` | `lib/probe.js` + `lib/transport.js` (vendored; no in-box changes) |
+
+## Features
+
+- **Managed MCP server registry** (host): persistent definitions (storage-domain `mcp_servers`), per-server
+  `@deepseek-ai/dsh-mcp-client` mounts, environment variable injection (plain values in the definition, secrets via credentials),
+  connection probe (`test`).
+- **Web settings page** (client): Settings → MCP — list / edit / delete / test servers.
+- **Server-level enable/disable**: disabling a server unmounts it and unregisters its tools immediately.
+- **Per-server refresh** button: re-pulls server status and tool list.
+- **Tool control**:
+  - Injection mode: `search` (on-demand, default — the model hot-injects tools via `mcp_tool_search`) and `full` (inject every enabled tool each request).
+  - Expandable per-server tool list, all checked by default; unchecking a tool keeps it out of injection. Changes take effect immediately.
+- **Remote self-mount**: the client half mounts the `mcpManager` Remote namespace itself via `ctx.remote.$mount()` in `apply()`,
+  so no in-box package modification is required.
+- Zero npm runtime dependencies (`@deepseek-ai/*` resolve from the DSH profiles module fallback).
+
+## Structure
+
+```
+dsh-mcp/
+├── package.json          name=dsh-mcp; dsh.client declaration; zero npm dependencies
+├── lib/
+│   ├── index.js          host half (McpManagerService, built from mcp-manager)
+│   ├── probe.js          vendored connection probe (from mcp-client/src/probe.ts)
+│   ├── transport.js      vendored transport factory (from mcp-client/src/transport.ts)
+│   └── client.js         browser half (esbuild bundle, ModuleLoader wire format)
+├── src/client/           browser half source (TSX + CSS Modules + local types + remote-contribution)
+└── scripts/build.mjs     build script (esbuild resolved from a DSH checkout, see below)
+```
+
+## Build
+
+```sh
+node scripts/build.mjs
+```
+
+- esbuild is resolved from a DSH source checkout: `$DSH_SOURCE`, or `~/.dsh/source/current` when unset.
+- Runtime dependencies (`@deepseek-ai/*`, `zod`, `@modelcontextprotocol/sdk`) are not installed as npm packages;
+  they resolve from `$DSH_HOME/profiles/node_modules` (DSH profiles module fallback, `$DSH_HOME` defaults to `~/.dsh`);
+  the build points `nodePaths` at the same directory.
+- CSS Modules are handled by an esbuild onLoad plugin: styles are injected into a
+  `<style data-plugin="dsh-mcp" data-file="…">` tag, and the module default-exports an identity class-name map.
+
+## Install
+
+### Option 1: npm (after publishing)
+
+```sh
+dsh plugin --profile web add dsh-mcp
+```
+
+### Option 2: GitHub git source
+
+```sh
+dsh plugin --profile web add github:ArvinQi/dsh-mcp
+# or
+dsh plugin --profile web add git+https://github.com/ArvinQi/dsh-mcp.git
+```
+
+### Option 3: local development (link)
+
+```sh
+dsh plugin --profile web add link:<absolute path to this repo>
+```
+
+> Note: with a local `link:` install, the plugin directory needs a `node_modules -> $DSH_HOME/profiles/node_modules`
+> symlink (development-only, not committed); otherwise the linked symlink is realpath-resolved and `@deepseek-ai/*`
+> cannot be resolved.
+
+### Registration (all install options)
+
+Append to `$DSH_HOME/profiles/web/cordis.patch.yml` (`$DSH_HOME` defaults to `~/.dsh`):
+
+```yaml
+- insert:
+    - id: dsh-mcp
+      name: dsh-mcp
+```
+
+Then **restart `dsh web`** (client roster changes require a restart); afterwards hard-refresh the browser
+(`Cmd/Ctrl + Shift + R`) to load the settings page.
+
+## Versioning notes
+
+- The host half `lib/index.js` is a **build artifact** of mcp-manager (spec/types inlined); edit the lib files
+  directly, or rebuild from TypeScript with the repository toolchain.
+- After changing `src/client/*`, re-run `node scripts/build.mjs`; host-half changes take effect without
+  reinstalling (link install).
+- Configuration changes (bundle additions/removals, new plugin rows) require restarting `dsh web` to enter
+  the client roster.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md). Released under the [MIT License](LICENSE).

package/README.md

@@ -0,0 +1,89 @@
+# dsh-mcp — MCP 服务器管理插件（独立版）
+
+**[English](README.en.md) | 简体中文**
+
+![设置页预览](static/snapshot.webp)
+
+## 功能
+
+- **托管 MCP 服务器注册表**（host）：持久化定义（storage-domain `mcp_servers`）、按服务器挂载
+  `@deepseek-ai/dsh-mcp-client` 实例、环境变量注入（明文入定义、secret 走 credentials）、
+  连接探测（test）。
+- **Web 设置管理页**（client）：Settings → MCP，列表/编辑/删除/测试服务器。
+- **Remote 自挂载**：client 半部在 `apply()` 里自行 `ctx.remote.$mount()` 挂载 `mcpManager`
+  命名空间（原实现依赖 api-remotes 的 in-box 修改，独立版不再需要任何 in-box 包改动）。
+
+## 结构
+
+```
+dsh-mcp/
+├── package.json          name=dsh-mcp；dsh.client 声明；零 npm dependencies
+├── lib/
+│   ├── index.js          host 半部（McpManagerService，源自 mcp-manager 构建产物）
+│   ├── probe.js          vendored 连接探测（源自 mcp-client/src/probe.ts）
+│   ├── transport.js      vendored 传输工厂（源自 mcp-client/src/transport.ts）
+│   └── client.js         浏览器半部（esbuild 打包，ModuleLoader wire format）
+├── src/client/           浏览器半部源码（TSX + CSS Modules + 本地 types + remote-contribution）
+└── scripts/build.mjs     构建脚本（esbuild 取自 DSH checkout，见下）
+```
+
+## 构建
+
+```sh
+node scripts/build.mjs
+```
+
+- esbuild 从 DSH 源码 checkout 解析：`$DSH_SOURCE` 未设置时尝试
+  `~/.dsh/source/current`。
+- 运行时依赖（`@deepseek-ai/*`、`zod`、`@modelcontextprotocol/sdk`）不装 npm 包，
+  从 `$DSH_HOME/profiles/node_modules`（DSH profiles 模块 fallback，`$DSH_HOME` 默认 `~/.dsh`）解析；构建时经
+  `nodePaths` 指向同一目录。
+- CSS Modules 由 esbuild onLoad 插件处理：样式注入
+  `<style data-plugin="dsh-mcp" data-file="…">`，默认导出 identity 类名映射。
+
+## 安装
+
+### 方式一：npm（发布到 npm 后）
+
+```sh
+dsh plugin --profile web add dsh-mcp
+```
+
+### 方式二：GitHub git 源
+
+```sh
+dsh plugin --profile web add github:ArvinQi/dsh-mcp
+# 或
+dsh plugin --profile web add git+https://github.com/ArvinQi/dsh-mcp.git
+```
+
+### 方式三：本地开发（link）
+
+```sh
+dsh plugin --profile web add link:<本仓库绝对路径>
+```
+
+> 注意：本地 `link:` 安装时，插件目录内含 `node_modules -> $DSH_HOME/profiles/node_modules`
+> symlink（本机开发用，不入库），否则 `link:` 安装的 symlink 被 realpath 后无法解析
+> `@deepseek-ai/*`。
+
+### 注册与生效（三种方式通用）
+
+在 `$DSH_HOME/profiles/web/cordis.patch.yml`（`$DSH_HOME` 默认 `~/.dsh`）追加：
+
+```yaml
+- insert:
+    - id: dsh-mcp
+      name: dsh-mcp
+```
+
+然后**重启 `dsh web`**（client roster 变更需重启）；之后浏览器硬刷新（`Cmd/Ctrl + Shift + R`）
+加载设置页。
+
+## 版本注意
+
+- host 半部 `lib/index.js` 是 mcp-manager 的**构建产物**（spec/types 已内联），改动请直接编辑
+  lib 下文件，或改回 TS 后重新用仓库工具链构建。
+- 浏览器半部改 `src/client/*` 后重新 `node scripts/build.mjs`；host 半部改动无需重装
+  （link 安装直接生效）。
+- 配置变更（bundles 增删、新插件行）需重启 `dsh web` 才进入 client roster。