dsh-mcp 1.0.0

package/lib/probe.js

@@ -0,0 +1,53 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { ListToolsResultSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createTransport } from "./transport.js";
+const DEFAULT_PROBE_TIMEOUT_MS = 15e3;
+function probeErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function runProbe(client, config) {
+  await client.connect(createTransport(config));
+  const tools = [];
+  let cursor;
+  do {
+    const response = await client.request(
+      { method: "tools/list", ...cursor === void 0 ? {} : { params: { cursor } } },
+      ListToolsResultSchema
+    );
+    for (const tool of response.tools) {
+      tools.push({
+        name: tool.name,
+        ...tool.description === void 0 ? {} : { description: tool.description }
+      });
+    }
+    cursor = response.nextCursor;
+  } while (cursor);
+  return { ok: true, tools };
+}
+async function probeConnection(config, options = {}) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new Error(`probeConnection: timeoutMs must be a positive finite number, received ${String(timeoutMs)}`);
+  }
+  const client = new Client(
+    { name: "dsh-mcp-client", version: "0.0.1" },
+    { capabilities: {} }
+  );
+  const timeout = new Promise((_, reject) => {
+    const timer = setTimeout(() => reject(new Error(`connection probe timed out after ${timeoutMs}ms`)), timeoutMs);
+    timer.unref();
+  });
+  try {
+    return await Promise.race([runProbe(client, config), timeout]);
+  } catch (error) {
+    return { ok: false, message: probeErrorMessage(error) };
+  } finally {
+    try {
+      await client.close();
+    } catch {
+    }
+  }
+}
+export {
+  probeConnection
+};

package/lib/transport.js

@@ -0,0 +1,25 @@
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { scrubbedParentEnv } from "@deepseek-ai/dsh-subprocess";
+function buildChildEnv(extra) {
+  return { ...scrubbedParentEnv(), ...extra };
+}
+function createTransport(config) {
+  switch (config.transport) {
+    case "stdio":
+      return new StdioClientTransport({
+        command: config.command,
+        args: config.args,
+        env: buildChildEnv(config.env),
+        cwd: config.cwd
+      });
+    case "streamable-http":
+      return new StreamableHTTPClientTransport(
+        new URL(config.url),
+        { requestInit: { headers: config.headers } }
+      );
+  }
+}
+export {
+  createTransport
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "dsh-mcp",
+  "version": "1.0.0",
+  "description": "MCP server 管理插件（独立版）：托管 MCP 服务器注册表（持久化定义、运行时挂载、环境变量注入、连接探测）+ Web 设置管理页。由 deepseek-harness 仓库内的 mcp-manager / ui-settings-mcp / web-mcp 迁移合并而来。MCP server registry with WebUI management for DeepSeek Harness.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "scripts",
+    "static",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
+    "CHANGELOG.en.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs"
+  },
+  "author": "Arvin.qi <arvin.qi@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArvinQi/dsh-mcp.git"
+  },
+  "homepage": "https://github.com/ArvinQi/dsh-mcp",
+  "bugs": {
+    "url": "https://github.com/ArvinQi/dsh-mcp/issues"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  }
+}

package/scripts/build.mjs

@@ -0,0 +1,144 @@
+/**
+ * Build the dsh-mcp client bundle.
+ *
+ * Produces lib/client.js in the exact wire format the DSH web shell expects:
+ * a CJS factory handed to window.__ModuleLoader__.load({ id, factory }), with
+ * platform modules resolved through the injected require (the loader module
+ * table) and everything else inlined.
+ *
+ * CSS Modules are handled by an esbuild onLoad plugin: each `.module.css` is
+ * rewritten to a JS module that (1) injects the stylesheet text into a
+ * <style data-plugin="dsh-mcp"> tag and (2) default-exports an identity class
+ * map (class name -> class name; the standalone plugin does not need hashed
+ * names because its UI is scoped to the settings section it owns).
+ *
+ * esbuild is resolved from the DSH source checkout (the only place it is
+ * installed); the plugin package itself has zero runtime dependencies.
+ * Set DSH_SOURCE to the DSH checkout root when it is not one of the known
+ * defaults below.
+ */
+import { createRequire } from 'node:module'
+import { fileURLToPath } from 'node:url'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+
+/** DSH source checkout root; override with $DSH_SOURCE when not a default. */
+function resolveCheckout() {
+  if (process.env.DSH_SOURCE && existsSync(process.env.DSH_SOURCE)) return process.env.DSH_SOURCE
+  const defaults = [
+    join(homedir(), '.dsh/source/current'),
+  ]
+  for (const candidate of defaults) {
+    if (existsSync(candidate)) return candidate
+  }
+  throw new Error('esbuild not found: set DSH_SOURCE to the DSH checkout root')
+}
+
+const CHECKOUT = resolveCheckout()
+
+/** Loader entry name — must equal the patch row `name` EXACTLY. */
+const MANIFEST = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8'))
+const PLUGIN_ID = MANIFEST.name
+
+/** Platform module table (must stay aligned with packages/client/web/src/platform.ts + the runtime exemption). */
+const EXTERNALS = [
+  'react',
+  'react/jsx-runtime',
+  'react-dom',
+  'react-dom/client',
+  '@deepseek-ai/cordis',
+  '@deepseek-ai/dsh-client-ui-slots',
+  '@deepseek-ai/dsh-client-web-react',
+  '@deepseek-ai/dsh-client-ui-primitives',
+  '@deepseek-ai/dsh-client-ui-attachment',
+  '@deepseek-ai/dsh-client-schema-form',
+  '@deepseek-ai/dsh-client-runtime/client',
+]
+
+/** Locate the esbuild package inside a pnpm checkout (store or hoisted). */
+function resolveEsbuild(checkout) {
+  const store = join(checkout, 'node_modules/.pnpm')
+  if (existsSync(store)) {
+    const entries = readdirSync(store).filter((name) => name.startsWith('esbuild@')).sort()
+    for (let i = entries.length - 1; i >= 0; i -= 1) {
+      const candidate = join(store, entries[i], 'node_modules/esbuild/package.json')
+      if (existsSync(candidate)) return candidate
+    }
+  }
+  const hoisted = join(checkout, 'node_modules/esbuild/package.json')
+  if (existsSync(hoisted)) return hoisted
+  throw new Error(`esbuild not found under ${checkout} (set DSH_SOURCE to the DSH checkout root)`)
+}
+
+const require = createRequire(resolveEsbuild(CHECKOUT))
+const esbuild = require('esbuild')
+
+/** Identity class map for one CSS module + the stylesheet text, as a JS module. */
+function cssModuleLoader() {
+  return {
+    name: 'dsh-mcp-css-modules',
+    setup(build) {
+      build.onLoad({ filter: /\.module\.css$/ }, (args) => {
+        const css = readFileSync(args.path, 'utf8')
+        const classes = [...new Set(
+          [...css.matchAll(/\.([A-Za-z_][A-Za-z0-9_-]*)/g)].map((match) => match[1]),
+        )]
+        const map = Object.fromEntries(classes.map((name) => [name, name]))
+        const file = args.path.split('/').pop()
+        const contents = [
+          `(function () {`,
+          `  if (typeof document !== 'undefined') {`,
+          `    const existing = document.querySelector('style[data-plugin="${PLUGIN_ID}"][data-file="${file}"]');`,
+          `    if (!existing) {`,
+          `      const style = document.createElement('style');`,
+          `      style.setAttribute('data-plugin', '${PLUGIN_ID}');`,
+          `      style.setAttribute('data-file', '${file}');`,
+          `      style.textContent = ${JSON.stringify(css)};`,
+          `      document.head.appendChild(style);`,
+          `    }`,
+          `  }`,
+          `})();`,
+          `export default ${JSON.stringify(map)};`,
+        ].join('\n')
+        return { contents, loader: 'js' }
+      })
+    },
+  }
+}
+
+const banner = [
+  `window.__ModuleLoader__.load({ id: ${JSON.stringify(PLUGIN_ID)}, factory: (require) => {`,
+  'var module = { exports: {} }; var exports = module.exports;',
+].join('\n')
+const footer = 'return module.exports; } });'
+
+await esbuild.build({
+  entryPoints: [join(ROOT, 'src/client/index.ts')],
+  outfile: join(ROOT, 'lib/client.js'),
+  bundle: true,
+  format: 'cjs',
+  platform: 'browser',
+  target: 'es2022',
+  // Components import only named react hooks (React 17+ style); the classic
+  // 'transform' mode emits bare `React.createElement` with no React binding in
+  // scope, which crashed the settings section with "React is not defined".
+  // 'automatic' emits jsx-runtime calls (`react/jsx-runtime` is already an
+  // external platform module), so no default React import is required.
+  jsx: 'automatic',
+  external: EXTERNALS,
+  // The plugin lives outside any node_modules tree of its own; the DSH
+  // profiles fallback directory is where zod (inlined into the bundle) and the
+  // external @deepseek-ai/* platform modules resolve from at build time.
+  nodePaths: [join(homedir(), '.dsh/profiles/node_modules')],
+  plugins: [cssModuleLoader()],
+  define: {
+    'process.env.NODE_ENV': '"production"',
+  },
+  banner: { js: banner },
+  footer: { js: footer },
+})
+
+console.log('lib/client.js built')

package/src/client/McpSettingsSection.module.css

@@ -0,0 +1,236 @@
+.section {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  width: 100%;
+  max-width: 760px;
+  color: var(--dsw-alias-label-primary);
+}
+
+.header {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+}
+
+.status,
+.failure p {
+  margin: 0;
+}
+
+.status,
+.failure {
+  font-size: 13px;
+  line-height: 20px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.failure {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  color: var(--dsw-alias-state-error-primary);
+}
+
+button {
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 6px;
+  padding: 5px 12px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font: inherit;
+  font-size: 13px;
+  line-height: 20px;
+  cursor: pointer;
+}
+
+button:hover {
+  background: var(--dsw-alias-interactive-bg-hover);
+}
+
+button:focus-visible {
+  outline: 2px solid var(--dsw-alias-state-business-primary);
+  outline-offset: 1px;
+}
+
+button:disabled {
+  cursor: not-allowed;
+  opacity: 0.55;
+}
+
+.primary {
+  border-color: var(--dsw-alias-state-business-primary);
+  background: var(--dsw-alias-state-business-primary);
+  color: var(--dsw-alias-label-on-accent);
+}
+
+.primary:hover {
+  background: var(--dsw-alias-state-business-primary-hover);
+}
+
+.list {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 10px;
+  padding: 10px 14px;
+  background: var(--dsw-alias-bg-layer-3);
+}
+
+.rowMain {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+}
+
+.rowTitle {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+
+.serverName {
+  overflow: hidden;
+  font-size: 14px;
+  line-height: 20px;
+  font-weight: 600;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.badge {
+  display: inline-flex;
+  align-items: center;
+  min-height: 18px;
+  border-radius: 5px;
+  padding: 1px 6px;
+  font-size: 11px;
+  line-height: 16px;
+  white-space: nowrap;
+}
+
+.badge.mounting {
+  background: color-mix(in srgb, var(--dsw-alias-state-business-primary) 12%, transparent);
+  color: var(--dsw-alias-state-business-primary);
+}
+
+.badge.live {
+  background: color-mix(in srgb, var(--dsw-alias-state-success-primary) 12%, transparent);
+  color: var(--dsw-alias-state-success-primary);
+}
+
+.badge.failed {
+  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent);
+  color: var(--dsw-alias-state-error-primary);
+}
+
+.badge.stopped {
+  background: var(--dsw-alias-bg-layer-1);
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.muted {
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.rowMeta {
+  display: flex;
+  gap: 14px;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+  line-height: 18px;
+  font-variant-numeric: tabular-nums;
+}
+
+.rowActions {
+  flex: none;
+}
+
+.card {
+  display: flex;
+  flex-direction: column;
+  gap: 0;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 10px;
+  background: var(--dsw-alias-bg-layer-3);
+}
+
+.card > .row {
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+}
+
+.modeRow {
+  display: flex;
+  align-items: center;
+  gap: 18px;
+  flex-wrap: wrap;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 10px;
+  padding: 8px 14px;
+  background: var(--dsw-alias-bg-layer-3);
+  font-size: 13px;
+  line-height: 20px;
+}
+
+.modeLabel {
+  font-weight: 600;
+}
+
+.modeOption {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  cursor: pointer;
+}
+
+.modeHint {
+  margin: 0;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+  line-height: 18px;
+}
+
+.toolPanel {
+  border-top: 1px solid var(--dsw-alias-border-l2);
+  padding: 10px 14px;
+}
+
+.toolGrid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));
+  gap: 4px 14px;
+  max-height: 320px;
+  overflow-y: auto;
+}
+
+.toolRow {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  padding: 2px 0;
+  font-size: 12px;
+  line-height: 18px;
+  cursor: pointer;
+}
+
+.toolName {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}