@huanlin/dsh-plugin-mcp-manager 0.1.0 → 0.1.2

package/lib/index.mjs

@@ -132,7 +132,7 @@ function configToData(config) {
 }
 /**
 * 读全部 MCP 服务器行。配置块缺失/结构异常的行被跳过（不抛——读路径容忍）。
-* 返回每行的 id 与解析出的 config（仅含存在的字段）。
+* 返回每行的 id 与解析出的 config（仅含存在的字段）+ entry-level disabled 标志。
 */
 function listServers() {
 	const doc = readPatchDocument();
@@ -147,10 +147,13 @@ function listServers() {
 		} catch {
 			continue;
 		}
+		const disabledRaw = row.get("disabled");
+		const disabled = disabledRaw === true || disabledRaw === "true";
 		out.push({
 			id,
 			name: MCP_CLIENT_PACKAGE,
-			config
+			config,
+			disabled
 		});
 	}
 	return out;
@@ -277,10 +280,29 @@ function deleteServer(id, opts) {
 	console.log(`[dsh-mcp-manager] deleted server ${id}`);
 	return true;
 }
+/**
+* 设置一个服务器的禁用状态。`disabled: true` 写在 entry level（与 id/name/config
+* 同级），loader 跳过挂载该 mcp-client 实例 → 工具不注册（模型不可见），配置保留。
+* 设为 false 时移除 `disabled` 字段（比 `disabled: false` 更干净），loader HMR
+* 重新挂载实例。
+*
+* @returns true 设置成功；false 行不存在。
+* @throws RegistryError 写后校验失败（已回滚）。
+*/
+function setServerDisabled(id, disabled, opts) {
+	const doc = readPatchDocument();
+	const target = collectMcpRows(doc).find((r) => r.id === id);
+	if (target === void 0) return false;
+	if (disabled) target.row.set("disabled", true);
+	else if (target.row.has("disabled")) target.row.delete("disabled");
+	writeAndValidate(doc, opts?.loadOverlayPatches);
+	console.log(`[dsh-mcp-manager] set server ${id} disabled=${disabled}`);
+	return true;
+}
 //#endregion
 //#region src/tools.ts
 /**
-* MCP 管理工具（mcp_* ×4）：agent 面的服务器注册表管理（对齐开发计划 §M4）。
+* MCP 管理工具（mcp_* ×5）：agent 面的服务器注册表管理（对齐开发计划 §M4）。
 * 与 GUI 面板写同一安装态（profile cordis.patch.yml 的 mcp-client insert 行），
 * 配置 HMR 实时挂载——agent 调用后工具立即可用（若服务器连接成功）。
 *
@@ -288,6 +310,8 @@ function deleteServer(id, opts) {
 * - mcp_server_add：新增服务器（校验 + 写 insert 行 → HMR 挂载 mcp-client 实例）
 * - mcp_server_update：整块替换 config（serverName 不变则工具名不变）
 * - mcp_server_remove：移除行 → 工具随实例 dispose 注销
+* - mcp_server_set_enabled：禁用/启用 entry-level disabled 字段（config 保留，
+*   禁用时 loader 跳过挂载 → 工具不注册 → 模型不可见）
 *
 * 依赖注入（deps）：避免与 index.ts 循环依赖。连接生命周期完全委托官方
 * mcp-client——管理插件只写配置，不拉连接。
@@ -295,10 +319,11 @@ function deleteServer(id, opts) {
 /** 把注册表行 + 运行态工具名投影为 agent 可见的规范视图。 */
 function toServerView(row, toolNames, connectingSince) {
 	const prefix = `mcp__${row.config.serverName}__`;
-	const toolCount = toolNames.filter((n) => n.startsWith(prefix)).length;
+	const toolCount = row.disabled ? 0 : toolNames.filter((n) => n.startsWith(prefix)).length;
 	const endpoint = row.config.transport === "stdio" ? `${row.config.command ?? ""} ${(row.config.args ?? []).join(" ")}`.trim() : row.config.url ?? "";
 	let status;
-	if (toolCount > 0) status = "connected";
+	if (row.disabled) status = "disabled";
+	else if (toolCount > 0) status = "connected";
 	else {
 		const since = connectingSince.get(row.config.serverName);
 		status = since !== void 0 && Date.now() - since < 3e4 ? "connecting" : "disconnected";
@@ -309,6 +334,7 @@ function toServerView(row, toolNames, connectingSince) {
 		transport: row.config.transport,
 		endpoint,
 		toolCount,
+		disabled: row.disabled,
 		status
 	};
 }
@@ -390,7 +416,7 @@ function createMcpTools(deps) {
 	return [
 		defineTool({
 			name: "mcp_server_list",
-			description: "List registered MCP servers and their live tool counts. Each server is an @deepseek-ai/dsh-mcp-client instance mounted from the profile cordis.patch.yml insert row. status: connected (tools registered), connecting (mcp-client mounting/handshaking within the post-write grace window), disconnected (0 tools past the grace window — failed/exhausted).",
+			description: "List registered MCP servers and their live tool counts. Each server is an @deepseek-ai/dsh-mcp-client instance mounted from the profile cordis.patch.yml insert row. status: connected (tools registered), connecting (mcp-client mounting/handshaking within the post-write grace window), disconnected (0 tools past the grace window — failed/exhausted), disabled (entry-level disabled=true — config preserved but loader skips mounting, tools not registered and invisible to the model).",
 			parameters: {},
 			output: {
 				schema: {
@@ -423,13 +449,18 @@ function createMcpTools(deps) {
 									type: "number",
 									required: true
 								},
+								disabled: {
+									type: "boolean",
+									required: true
+								},
 								status: {
 									type: "string",
 									required: true,
 									enum: [
 										"connected",
 										"connecting",
-										"disconnected"
+										"disconnected",
+										"disabled"
 									]
 								}
 							}
@@ -568,6 +599,61 @@ function createMcpTools(deps) {
 					message: `mcp_server_remove: removed "${id}" — mcp-client disposing, tools unregistering.`
 				};
 			}
+		}),
+		defineTool({
+			name: "mcp_server_set_enabled",
+			description: "Enable or disable an MCP server without deleting its config. Sets the entry-level `disabled` field (sibling of id/name/config) in the profile cordis.patch.yml. When disabled, the loader skips mounting the @deepseek-ai/dsh-mcp-client instance — its tools (mcp__<serverName>__*) are NOT registered and the model CANNOT see or call them. The config block is preserved verbatim, so re-enabling is a no-cost toggle (no re-entry of fields). Use this instead of mcp_server_remove when you want to temporarily hide a server from the model.",
+			parameters: {
+				id: {
+					type: "string",
+					required: true,
+					description: "The server insert-row id (e.g. mcp-github)."
+				},
+				enabled: {
+					type: "boolean",
+					required: true,
+					description: "true = mount the instance (tools visible); false = skip mounting (tools hidden, config preserved)."
+				}
+			},
+			output: {
+				schema: {
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						ok: {
+							type: "boolean",
+							required: true
+						},
+						id: {
+							type: "string",
+							required: true
+						},
+						enabled: {
+							type: "boolean",
+							required: true
+						},
+						message: {
+							type: "string",
+							required: true
+						}
+					}
+				},
+				render: (_args, value) => [{
+					type: "text",
+					text: value.message
+				}]
+			},
+			async execute(args) {
+				const id = String(args.id);
+				const enabled = Boolean(args.enabled);
+				deps.setServerDisabled(id, !enabled);
+				return {
+					ok: true,
+					id,
+					enabled,
+					message: enabled ? `mcp_server_set_enabled: enabled "${id}" — mcp-client mounting via config HMR, tools will appear as mcp__<serverName>__* once the connection succeeds.` : `mcp_server_set_enabled: disabled "${id}" — mcp-client disposing, tools unregistering. Config preserved in patch file; re-enable anytime.`
+				};
+			}
 		})
 	];
 }
@@ -599,8 +685,9 @@ function readBody(req) {
 * 这是 P0 朴素推断（对齐开发计划 §4），非真实连接状态。
 */
 const CONNECTING_GRACE_MS = 3e4;
-/** 计算一个服务器的三态状态。 */
-function computeStatus(toolCount, serverName, connectingSince) {
+/** 计算一个服务器的四态状态。 */
+function computeStatus(toolCount, serverName, connectingSince, disabled) {
+	if (disabled) return "disabled";
 	if (toolCount > 0) return "connected";
 	const since = connectingSince.get(serverName);
 	if (since !== void 0 && Date.now() - since < CONNECTING_GRACE_MS) return "connecting";
@@ -620,6 +707,10 @@ function apply(ctx) {
 		const markConnecting = (serverName) => {
 			connectingSince.set(serverName, Date.now());
 		};
+		/** 清除连接中标记（禁用时调用——不再处于连接中，而是已禁用）。 */
+		const clearConnecting = (serverName) => {
+			connectingSince.delete(serverName);
+		};
 		const mcpTools = createMcpTools({
 			listServers,
 			addServer: (config, opts) => {
@@ -635,6 +726,16 @@ function apply(ctx) {
 				markConnecting(config.serverName);
 			},
 			deleteServer: (id) => deleteServer(id, { loadOverlayPatches }),
+			setServerDisabled: (id, disabled) => {
+				setServerDisabled(id, disabled, { loadOverlayPatches });
+				if (disabled) {
+					const row = listServers().find((r) => r.id === id);
+					if (row !== void 0) clearConnecting(row.config.serverName);
+				} else {
+					const row = listServers().find((r) => r.id === id);
+					if (row !== void 0) markConnecting(row.config.serverName);
+				}
+			},
 			registeredToolNames: () => (ctx.tools?.schemas() ?? []).map((s) => s.name),
 			connectingSince,
 			selfId: "@huanlin/dsh-plugin-mcp-manager"
@@ -665,14 +766,15 @@ function apply(ctx) {
 							ok: true,
 							servers: listServers().map((row) => {
 								const prefix = `mcp__${row.config.serverName}__`;
-								const toolCount = toolNames.filter((n) => n.startsWith(prefix)).length;
+								const toolCount = row.disabled ? 0 : toolNames.filter((n) => n.startsWith(prefix)).length;
 								return {
 									id: row.id,
 									serverName: row.config.serverName,
 									transport: row.config.transport,
 									endpoint: row.config.transport === "stdio" ? `${row.config.command ?? ""} ${(row.config.args ?? []).join(" ")}`.trim() : row.config.url ?? "",
 									toolCount,
-									status: computeStatus(toolCount, row.config.serverName, connectingSince),
+									disabled: row.disabled,
+									status: computeStatus(toolCount, row.config.serverName, connectingSince, row.disabled),
 									config: row.config
 								};
 							})
@@ -713,12 +815,13 @@ function apply(ctx) {
 							ok: true,
 							status: listServers().map((row) => {
 								const prefix = `mcp__${row.config.serverName}__`;
-								const toolCount = toolNames.filter((n) => n.startsWith(prefix)).length;
+								const toolCount = row.disabled ? 0 : toolNames.filter((n) => n.startsWith(prefix)).length;
 								return {
 									id: row.id,
 									serverName: row.config.serverName,
 									toolCount,
-									status: computeStatus(toolCount, row.config.serverName, connectingSince)
+									disabled: row.disabled,
+									status: computeStatus(toolCount, row.config.serverName, connectingSince, row.disabled)
 								};
 							})
 						});
@@ -769,6 +872,37 @@ function apply(ctx) {
 						});
 						return;
 					}
+					if (method === "PATCH" && putMatch !== null) {
+						const id = decodeURIComponent(putMatch[1]);
+						const body = await readBody(req);
+						const parsed = JSON.parse(body);
+						if (parsed.disabled === void 0 || typeof parsed.disabled !== "boolean") {
+							jsonRes(400, {
+								ok: false,
+								message: "disabled (boolean) is required"
+							});
+							return;
+						}
+						if (!setServerDisabled(id, parsed.disabled, { loadOverlayPatches })) {
+							jsonRes(404, {
+								ok: false,
+								message: `server "${id}" not found`
+							});
+							return;
+						}
+						const row = listServers().find((r) => r.id === id);
+						if (row !== void 0) {
+							if (parsed.disabled) connectingSince.delete(row.config.serverName);
+							else markConnecting(row.config.serverName);
+						}
+						jsonRes(200, {
+							ok: true,
+							id,
+							disabled: parsed.disabled,
+							message: `server ${id} ${parsed.disabled ? "disabled" : "enabled"} (config preserved)`
+						});
+						return;
+					}
 					if (method === "DELETE" && putMatch !== null) {
 						const id = decodeURIComponent(putMatch[1]);
 						if (!deleteServer(id, { loadOverlayPatches })) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@huanlin/dsh-plugin-mcp-manager",
   "description": "MCP 服务器管理面板：GUI 增删改 MCP 服务器配置（写入 profile cordis.patch.yml 的 mcp-client insert 行，配置 HMR 实时挂载）+ 工具浏览 + agent 面 mcp_* 管理工具。连接生命周期委托官方 @deepseek-ai/dsh-mcp-client。",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "publishConfig": {
     "access": "public"
   },