feat(pdu): add PDU MCP server for AI-driven SNMP power control

New ETTerms.PduMcp stdio MCP server lets AI agents (Kiro/Claude CLI)
control SNMP PDU outlets directly. Unlike serial, SNMP is non-exclusive
so it talks to the PDU directly without bridging through the GUI.

Tools: pdu_connect / pdu_list / pdu_set_port / pdu_get_port / pdu_status
/ pdu_power_cycle / pdu_disconnect.

- McpRegistrar now registers both etterms-serial and etterms-pdu in one click
- Settings -> AI MCP shows both server paths
- publish target (PublishMcpServers) bundles both MCP servers
- bump version to 0.3.0, update About changelog, ARCHITECTURE.md, CLAUDE.md

src/ETTerms.PduMcp/ETTerms.PduMcp.csproj

@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <RootNamespace>ETTerms.PduMcp</RootNamespace>
+    <AssemblyName>ETTerms.PduMcp</AssemblyName>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="ModelContextProtocol" Version="1.2.0" />
+    <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.1" />
+    <PackageReference Include="SnmpSharpNet" Version="0.9.7">
+      <NoWarn>NU1701</NoWarn>
+    </PackageReference>
+  </ItemGroup>
+
+</Project>

src/ETTerms.PduMcp/PduController.cs

@@ -0,0 +1,92 @@
+using System.Net;
+using SnmpSharpNet;
+
+namespace ETTerms.PduMcp;
+
+/// <summary>
+/// PDU controller for iPoMan II/III models via SNMP (slim copy of the GUI's
+/// ETTerms.Scripting.Pdu.PduController, ported into the standalone MCP server).
+///
+/// Differences from the GUI version:
+///   • No dependency on ETTerms.Infrastructure.AppLogger — diagnostics go to stderr
+///     (stdout is reserved for the MCP JSON-RPC stream).
+///   • Adds <see cref="GetModelName"/> so tools can surface the device identity.
+///
+/// SNMP is connectionless (UDP) and non-exclusive, so this talks to the PDU directly
+/// without bridging through the GUI.
+/// </summary>
+public sealed class PduController : IDisposable
+{
+    private readonly string _ip;
+    private const string Community = "private";
+    private const int SnmpPort = 161;
+    private const int Timeout = 3000;
+
+    public string Ip => _ip;
+
+    public PduController(string ip) => _ip = ip;
+
+    /// <summary>Reads the PDU model/name OID; non-empty containing "PDU" means reachable.</summary>
+    public string? GetModelName() => SnmpGet(".1.3.6.1.4.1.2468.1.4.2.1.1.4");
+
+    public bool CheckConnection()
+    {
+        var name = GetModelName();
+        Log($"CheckConnection {_ip}: name='{name ?? "<null>"}'");
+        return !string.IsNullOrEmpty(name) && name.Contains("PDU");
+    }
+
+    public bool SetPortOn(int port) => SnmpSet(PortControlOid(port), new Integer32(3));
+    public bool SetPortOff(int port) => SnmpSet(PortControlOid(port), new Integer32(4));
+
+    /// <summary>true = on, false = off, null = unknown/unreachable.</summary>
+    public bool? GetPortState(int port)
+    {
+        var r = SnmpGet(PortStateOid(port));
+        return r == "3" ? true : (r == "2" || r == "4") ? false : null;
+    }
+
+    public int? GetPortCurrent(int port) => int.TryParse(SnmpGet(PortCurrentOid(port)), out int v) ? v : null;
+    public double? GetPortPowerWatts(int port) => int.TryParse(SnmpGet(PortPowerOid(port)), out int v) ? v / 10.0 : null;
+
+    private static string PortControlOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.4.1.2.{port}";
+    private static string PortStateOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.2.{port}";
+    private static string PortCurrentOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.3.{port}";
+    private static string PortPowerOid(int port) => $".1.3.6.1.4.1.2468.1.4.2.1.3.2.3.1.5.{port}";
+
+    private bool SnmpSet(string oid, AsnType value)
+    {
+        try
+        {
+            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
+            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
+            var pdu = new SnmpSharpNet.Pdu(PduType.Set);
+            pdu.VbList.Add(new Oid(oid), value);
+            var result = (SnmpV1Packet)target.Request(pdu, param);
+            return result?.Pdu.ErrorStatus == 0;
+        }
+        catch (Exception ex) { Log($"SNMP SET {oid} exception: {ex.Message}"); return false; }
+    }
+
+    private string? SnmpGet(string oid)
+    {
+        try
+        {
+            var param = new AgentParameters(new OctetString(Community)) { Version = SnmpVersion.Ver1 };
+            using var target = new UdpTarget((IPAddress)new IpAddress(_ip), SnmpPort, Timeout, 1);
+            var pdu = new SnmpSharpNet.Pdu(PduType.Get);
+            pdu.VbList.Add(new Oid(oid));
+            var result = (SnmpV1Packet)target.Request(pdu, param);
+            if (result == null) { Log($"SNMP GET {oid}: no response (timeout)"); return null; }
+            if (result.Pdu.ErrorStatus != 0) { Log($"SNMP GET {oid}: ErrorStatus={result.Pdu.ErrorStatus}"); return null; }
+            foreach (var v in result.Pdu.VbList) return v.Value.ToString();
+        }
+        catch (Exception ex) { Log($"SNMP GET {oid} exception: {ex.Message}"); }
+        return null;
+    }
+
+    // stdio MCP server：stdout 專供 JSON-RPC，診斷一律走 stderr。
+    private static void Log(string msg) => Console.Error.WriteLine($"[PDU] {msg}");
+
+    public void Dispose() { }
+}

src/ETTerms.PduMcp/PduRegistry.cs

@@ -0,0 +1,31 @@
+using System.Collections.Concurrent;
+
+namespace ETTerms.PduMcp;
+
+/// <summary>
+/// Process-wide registry of connected PDUs, keyed by IP. The MCP server is long-lived,
+/// so connections established by <c>pdu_connect</c> persist across tool calls.
+/// </summary>
+public sealed class PduRegistry
+{
+    public static readonly PduRegistry Instance = new();
+
+    /// <summary>iPoMan II/III outlet count.</summary>
+    public const int PortCount = 12;
+
+    private readonly ConcurrentDictionary<string, PduController> _pdus = new(StringComparer.OrdinalIgnoreCase);
+
+    public PduController GetOrAdd(string ip) =>
+        _pdus.GetOrAdd(ip.Trim(), static k => new PduController(k));
+
+    public bool TryGet(string ip, out PduController pdu) =>
+        _pdus.TryGetValue(ip.Trim(), out pdu!);
+
+    public bool Remove(string ip)
+    {
+        if (_pdus.TryRemove(ip.Trim(), out var pdu)) { pdu.Dispose(); return true; }
+        return false;
+    }
+
+    public IReadOnlyCollection<string> ConnectedIps => _pdus.Keys.ToArray();
+}

src/ETTerms.PduMcp/PduTools.cs

@@ -0,0 +1,132 @@
+using System.ComponentModel;
+using System.Text;
+using System.Text.Json;
+using ModelContextProtocol.Server;
+
+namespace ETTerms.PduMcp;
+
+/// <summary>
+/// MCP tools exposed to the AI for controlling an SNMP PDU (iPoMan II/III).
+///
+/// Unlike the serial bridge, the PDU is reached directly over SNMP — the ETTerms GUI
+/// does NOT need to be running. Connections are held per-IP and persist for the lifetime
+/// of this MCP server. Always <c>pdu_connect</c> an IP first, then control its ports.
+/// </summary>
+[McpServerToolType]
+public static class PduTools
+{
+    private static readonly JsonSerializerOptions Json = new() { WriteIndented = false };
+
+    [McpServerTool, Description("Connect to a PDU over SNMP by IP and verify it responds. Required before controlling ports. Returns the model name on success.")]
+    public static Task<string> pdu_connect(
+        [Description("PDU IP address, e.g. 192.168.1.21")] string ip)
+    {
+        ip = (ip ?? "").Trim();
+        if (ip.Length == 0) return Err("ip is required");
+        var pdu = PduRegistry.Instance.GetOrAdd(ip);
+        var model = pdu.GetModelName();
+        bool ok = !string.IsNullOrEmpty(model) && model.Contains("PDU");
+        if (!ok)
+        {
+            PduRegistry.Instance.Remove(ip);
+            return Err($"no SNMP response from PDU at {ip} (check IP/network/community)");
+        }
+        return Ok(new { ip, model });
+    }
+
+    [McpServerTool, Description("List PDUs currently connected in this MCP session (by IP).")]
+    public static Task<string> pdu_list()
+        => Ok(new { connected = PduRegistry.Instance.ConnectedIps });
+
+    [McpServerTool, Description("Turn a PDU outlet on or off. The PDU must be connected first via pdu_connect.")]
+    public static Task<string> pdu_set_port(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port,
+        [Description("true = ON, false = OFF")] bool on)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return Err(error);
+        bool ok = on ? pdu.SetPortOn(port) : pdu.SetPortOff(port);
+        if (!ok) return Err($"SNMP set failed for {ip} port {port}");
+        return Ok(new { ip, port, state = on ? "on" : "off" });
+    }
+
+    [McpServerTool, Description("Read a single outlet's state, current (mA) and power (W).")]
+    public static Task<string> pdu_get_port(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return Err(error);
+        return Ok(PortSnapshot(pdu, port));
+    }
+
+    [McpServerTool, Description("Read the state, current (mA) and power (W) of all outlets on the PDU.")]
+    public static Task<string> pdu_status(
+        [Description("PDU IP address")] string ip)
+    {
+        if (!PduRegistry.Instance.TryGet(ip, out var pdu))
+            return Err($"PDU {ip} not connected. Call pdu_connect first.");
+        var ports = new List<object>();
+        for (int p = 1; p <= PduRegistry.PortCount; p++)
+            ports.Add(PortSnapshot(pdu, p));
+        return Ok(new { ip, ports });
+    }
+
+    [McpServerTool, Description("Power-cycle an outlet: turn it OFF, wait offSeconds, then turn it ON. Useful for rebooting a DUT.")]
+    public static async Task<string> pdu_power_cycle(
+        [Description("PDU IP address")] string ip,
+        [Description("Outlet/port number (1-12)")] int port,
+        [Description("Seconds to stay off before powering back on")] int offSeconds = 5)
+    {
+        if (!TryResolve(ip, port, out var pdu, out var error)) return await Err(error);
+        if (offSeconds < 0) offSeconds = 0;
+        if (!pdu.SetPortOff(port)) return await Err($"SNMP off failed for {ip} port {port}");
+        await Task.Delay(offSeconds * 1000);
+        if (!pdu.SetPortOn(port)) return await Err($"SNMP on failed for {ip} port {port}");
+        return await Ok(new { ip, port, action = "power_cycle", offSeconds, state = "on" });
+    }
+
+    [McpServerTool, Description("Disconnect a PDU from this MCP session (does not change outlet states).")]
+    public static Task<string> pdu_disconnect(
+        [Description("PDU IP address")] string ip)
+        => Ok(new { ip, removed = PduRegistry.Instance.Remove(ip) });
+
+    // ── helpers ──
+
+    private static bool TryResolve(string ip, int port, out PduController pdu, out string error)
+    {
+        pdu = null!;
+        error = "";
+        if (port < 1 || port > PduRegistry.PortCount)
+        {
+            error = $"port must be 1-{PduRegistry.PortCount}";
+            return false;
+        }
+        if (!PduRegistry.Instance.TryGet(ip, out pdu))
+        {
+            error = $"PDU {ip} not connected. Call pdu_connect first.";
+            return false;
+        }
+        return true;
+    }
+
+    private static object PortSnapshot(PduController pdu, int port)
+    {
+        var state = pdu.GetPortState(port);
+        return new
+        {
+            port,
+            state = state == true ? "on" : state == false ? "off" : "unknown",
+            currentMilliAmps = pdu.GetPortCurrent(port),
+            powerWatts = pdu.GetPortPowerWatts(port)
+        };
+    }
+
+    private static Task<string> Ok(object payload)
+    {
+        var node = new { ok = true, result = payload };
+        return Task.FromResult(JsonSerializer.Serialize(node, Json));
+    }
+
+    private static Task<string> Err(string message)
+        => Task.FromResult(JsonSerializer.Serialize(new { ok = false, error = message }, Json));
+}

src/ETTerms.PduMcp/Program.cs

@@ -0,0 +1,17 @@
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+
+// stdio MCP server：把 SNMP PDU 控制暴露給 AI（Kiro / Claude CLI）。
+// 與 ETTerms.SerialMcp 不同，PDU 走 SNMP(UDP) 非獨佔，故直接打 SNMP，不需 GUI 在跑。
+var builder = Host.CreateApplicationBuilder(args);
+
+// stdio 傳輸：stdout 專供 JSON-RPC，log 一律走 stderr，否則會污染協議。
+builder.Logging.AddConsole(o => o.LogToStandardErrorThreshold = LogLevel.Trace);
+
+builder.Services
+    .AddMcpServer()
+    .WithStdioServerTransport()
+    .WithToolsFromAssembly();
+
+await builder.Build().RunAsync();

src/ETTerms/App/AboutView.cs

@@ -183,6 +183,13 @@ public sealed class AboutView : UserControl
 
     private static readonly ChangelogEntry[] Changelog =
     [
+        new("0.3.0", new DateOnly(2026, 6, 8), "feat: PDU MCP server",
+        [
+            "New ETTerms.PduMcp server: AI agents (Kiro / Claude CLI) can now control SNMP PDU outlets directly.",
+            "Tools: pdu_connect / pdu_list / pdu_set_port / pdu_get_port / pdu_status / pdu_power_cycle / pdu_disconnect.",
+            "PDU runs over SNMP, so the AI can power-cycle a DUT without the GUI session being open.",
+            "Settings → AI MCP now registers both Serial and PDU MCP servers with one click.",
+        ]),
         new("0.2.2", new DateOnly(2026, 6, 5), "Bugfix — terminal stability",
         [
             "Fixed: the terminal no longer freezes after minimizing or switching tabs (notably in PowerShell / Kiro).",

src/ETTerms/App/SettingsView.cs

@@ -291,28 +291,30 @@ public sealed class SettingsView : UserControl
         });
         flow.Controls.Add(new Label
         {
-            Text = "One-click register the ETTerms Serial MCP server into your AI CLI's user-level\n" +
-                   "config. ETTerms keeps sole ownership of the COM port; the AI drives serial through\n" +
-                   "a local named pipe. Open a Serial session in ETTerms first, then the AI can attach.",
-            AutoSize = false, Width = 600, Height = 56,
+            Text = "One-click register the ETTerms MCP servers (Serial + PDU) into your AI CLI's\n" +
+                   "user-level config. Serial: ETTerms owns the COM port, the AI drives it through a\n" +
+                   "local named pipe (open a Serial session first). PDU: the AI controls outlets\n" +
+                   "directly over SNMP — no GUI session required.",
+            AutoSize = false, Width = 600, Height = 64,
             ForeColor = Theme.TextDim, Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 8)
         });
 
-        // Resolved MCP server exe
-        var exe = McpRegistrar.ResolveServerExe();
-        var exists = McpRegistrar.ServerExeExists();
-        flow.Controls.Add(new Label
-        {
-            Text = $"MCP server:  {exe}",
-            AutoSize = false, Width = 600, Height = 20,
-            ForeColor = exists ? Theme.SerialColor : Color.FromArgb(210, 150, 120),
-            Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 2)
-        });
-        if (!exists)
+        // Resolved MCP server exes (serial + pdu)
+        foreach (var (name, exe, exists) in McpRegistrar.ServerInfos())
         {
             flow.Controls.Add(new Label
             {
-                Text = "⚠ Not found yet — publish the app (or build ETTerms.SerialMcp). Setup still writes this expected path.",
+                Text = $"{name}:  {exe}",
+                AutoSize = false, Width = 600, Height = 20,
+                ForeColor = exists ? Theme.SerialColor : Color.FromArgb(210, 150, 120),
+                Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 2)
+            });
+        }
+        if (!McpRegistrar.ServerExeExists())
+        {
+            flow.Controls.Add(new Label
+            {
+                Text = "⚠ Some servers not built yet — publish the app (or build the MCP projects). Setup still writes the expected paths.",
                 AutoSize = false, Width = 600, Height = 20,
                 ForeColor = Color.FromArgb(210, 150, 120), Font = Theme.UiFont, Margin = new Padding(0, 0, 0, 4)
             });

src/ETTerms/ETTerms.csproj

@@ -10,7 +10,7 @@
     <AssemblyName>ETTerms</AssemblyName>
 
     <!-- 版本資訊 -->
-    <Version>0.2.2</Version>
+    <Version>0.3.0</Version>
     <Product>ETTerms</Product>
     <Company>ETTerms Project</Company>
 
@@ -36,13 +36,13 @@
   </ItemGroup>
 
   <!--
-    發佈 GUI 時，自動把 Serial MCP server 一併發佈到 <publish>\ETTerms.SerialMcp\ 子資料夾。
+    發佈 GUI 時，自動把 MCP servers（Serial + PDU）一併發佈到 <publish>\<server>\ 子資料夾。
     這樣單一 `dotnet publish src\ETTerms` 就會產生完整自洽的 bundle，
-    且 McpRegistrar.ResolveServerExe() 解析的 <ETTerms.exe>\ETTerms.SerialMcp\ETTerms.SerialMcp.exe 必定存在。
+    且 McpRegistrar.ResolveServerExe() 解析的 <ETTerms.exe>\<server>\<server>.exe 必定存在。
     刻意放子資料夾：與 GUI 的相依 dll 隔離，避免互相覆蓋。
     MCP 跟隨 GUI 的 self-contained 設定：框架相依版 → MCP 也框架相依；portable(self-contained)版 → MCP 也免 runtime。
   -->
-  <Target Name="PublishSerialMcp" AfterTargets="Publish">
+  <Target Name="PublishMcpServers" AfterTargets="Publish">
     <PropertyGroup>
       <_McpRid Condition="'$(RuntimeIdentifier)' != ''">$(RuntimeIdentifier)</_McpRid>
       <_McpRid Condition="'$(RuntimeIdentifier)' == ''">win-x64</_McpRid>
@@ -51,6 +51,8 @@
     </PropertyGroup>
     <Message Importance="high" Text="[ETTerms] Publishing ETTerms.SerialMcp -> $(PublishDir)ETTerms.SerialMcp (self-contained=$(_McpSelfContained))" />
     <Exec Command="dotnet publish &quot;$(MSBuildThisFileDirectory)..\ETTerms.SerialMcp\ETTerms.SerialMcp.csproj&quot; -c $(Configuration) -r $(_McpRid) --self-contained $(_McpSelfContained) -o &quot;$(PublishDir)ETTerms.SerialMcp&quot;" />
+    <Message Importance="high" Text="[ETTerms] Publishing ETTerms.PduMcp -> $(PublishDir)ETTerms.PduMcp (self-contained=$(_McpSelfContained))" />
+    <Exec Command="dotnet publish &quot;$(MSBuildThisFileDirectory)..\ETTerms.PduMcp\ETTerms.PduMcp.csproj&quot; -c $(Configuration) -r $(_McpRid) --self-contained $(_McpSelfContained) -o &quot;$(PublishDir)ETTerms.PduMcp&quot;" />
   </Target>
 
 </Project>

src/ETTerms/Infrastructure/McpRegistrar.cs

@@ -8,16 +8,25 @@ namespace ETTerms.Infrastructure;
 public enum McpTarget { Claude, Kiro }
 
 /// <summary>
-/// 把 ETTerms 的 Serial MCP server（<c>ETTerms.SerialMcp</c>）一鍵註冊 / 移除到
-/// 各 AI CLI 的「使用者層級」MCP 設定檔。採 read-modify-write，保留檔內其他既有伺服器。
+/// 把 ETTerms 的 MCP servers（<c>ETTerms.SerialMcp</c> 與 <c>ETTerms.PduMcp</c>）一鍵註冊 /
+/// 移除到各 AI CLI 的「使用者層級」MCP 設定檔。採 read-modify-write，保留檔內其他既有伺服器。
 ///
 /// - Claude Code：<c>~/.claude.json</c> 頂層 <c>mcpServers</c>，entry 需 <c>type:"stdio"</c>。
 /// - Kiro：<c>%USERPROFILE%\.kiro\settings\mcp.json</c> 頂層 <c>mcpServers</c>。
+///
+/// 兩個 server 一起註冊 / 移除（一鍵同時設定 serial 與 pdu）。
 /// </summary>
 public static class McpRegistrar
 {
-    /// <summary>註冊到各 CLI 時用的 MCP server 名稱。</summary>
-    public const string ServerName = "etterms-serial";
+    /// <summary>一個可被註冊的 MCP server 描述：CLI 內名稱 + 發佈子資料夾 + 執行檔名。</summary>
+    public sealed record McpServer(string Name, string PublishFolder, string ExeName);
+
+    /// <summary>ETTerms 提供的所有 MCP servers。</summary>
+    public static readonly IReadOnlyList<McpServer> Servers = new[]
+    {
+        new McpServer("etterms-serial", "ETTerms.SerialMcp", "ETTerms.SerialMcp.exe"),
+        new McpServer("etterms-pdu",    "ETTerms.PduMcp",    "ETTerms.PduMcp.exe"),
+    };
 
     public static string DisplayName(McpTarget t) => t switch
     {
@@ -43,33 +52,33 @@ public static class McpRegistrar
     {
         McpTarget.Claude =>
             "claude mcp list\r\n" +
-            $"#  應看到：{ServerName}  ✓ Connected\r\n" +
-            $"#  細節：  claude mcp get {ServerName}",
+            "#  應看到：etterms-serial / etterms-pdu  ✓ Connected\r\n" +
+            "#  細節：  claude mcp get etterms-pdu",
         McpTarget.Kiro =>
             "kiro-cli mcp list\r\n" +
-            $"kiro-cli mcp status --name {ServerName}\r\n" +
+            "kiro-cli mcp status --name etterms-pdu\r\n" +
             "#  或在 Kiro IDE：點 ghost 圖示開 MCP Servers 面板查看狀態",
         _ => ""
     };
 
-    /// <summary>找出 ETTerms.SerialMcp 執行檔路徑（找不到回傳最可能的位置作為註冊值）。</summary>
-    public static string ResolveServerExe()
+    /// <summary>找出某個 MCP server 執行檔路徑（找不到回傳最可能的位置作為註冊值）。</summary>
+    public static string ResolveServerExe(McpServer server)
     {
         var baseDir = AppContext.BaseDirectory;
         var candidates = new List<string>
         {
-            Path.Combine(baseDir, "ETTerms.SerialMcp", "ETTerms.SerialMcp.exe"), // 發佈版（子資料夾）
-            Path.Combine(baseDir, "ETTerms.SerialMcp.exe"),                       // 同層
+            Path.Combine(baseDir, server.PublishFolder, server.ExeName), // 發佈版（子資料夾）
+            Path.Combine(baseDir, server.ExeName),                       // 同層
         };
 
-        // 開發版 fallback：src\ETTerms\bin\<cfg>\net8.0-windows → src\ETTerms.SerialMcp\bin\<cfg>\net8.0
+        // 開發版 fallback：src\ETTerms\bin\<cfg>\net8.0-windows → src\<folder>\bin\<cfg>\net8.0
         try
         {
             var binCfg = new DirectoryInfo(baseDir);          // ...\net8.0-windows
             var config = binCfg.Parent?.Name ?? "Debug";       // Debug / Release
             var srcDir = binCfg.Parent?.Parent?.Parent?.Parent; // ...\src
             if (srcDir != null)
-                candidates.Add(Path.Combine(srcDir.FullName, "ETTerms.SerialMcp", "bin", config, "net8.0", "ETTerms.SerialMcp.exe"));
+                candidates.Add(Path.Combine(srcDir.FullName, server.PublishFolder, "bin", config, "net8.0", server.ExeName));
         }
         catch { /* 路徑推導失敗就略過開發版 fallback */ }
 
@@ -78,22 +87,34 @@ public static class McpRegistrar
         return candidates[0]; // 都找不到 → 回發佈版預期位置
     }
 
-    public static bool ServerExeExists() => File.Exists(ResolveServerExe());
+    /// <summary>所有 server 執行檔是否都存在。</summary>
+    public static bool ServerExeExists() => Servers.All(s => File.Exists(ResolveServerExe(s)));
 
-    /// <summary>該目標是否已註冊 etterms-serial。</summary>
+    /// <summary>列出每個 server 的解析路徑與是否存在（給 UI 顯示）。</summary>
+    public static IEnumerable<(string Name, string Exe, bool Exists)> ServerInfos()
+    {
+        foreach (var s in Servers)
+        {
+            var exe = ResolveServerExe(s);
+            yield return (s.Name, exe, File.Exists(exe));
+        }
+    }
+
+    /// <summary>該目標是否已註冊「全部」ETTerms MCP servers。</summary>
     public static bool IsRegistered(McpTarget t)
     {
         try
         {
             var path = ConfigPath(t);
             if (!File.Exists(path)) return false;
-            var root = JsonNode.Parse(File.ReadAllText(path)) as JsonObject;
-            return (root?["mcpServers"] as JsonObject)?[ServerName] != null;
+            var servers = (JsonNode.Parse(File.ReadAllText(path)) as JsonObject)?["mcpServers"] as JsonObject;
+            if (servers == null) return false;
+            return Servers.All(s => servers[s.Name] != null);
         }
         catch { return false; }
     }
 
-    /// <summary>註冊（或更新）etterms-serial 到該目標設定檔。</summary>
+    /// <summary>註冊（或更新）所有 ETTerms MCP servers 到該目標設定檔。</summary>
     public static void Register(McpTarget t)
     {
         var path = ConfigPath(t);
@@ -106,27 +127,34 @@ public static class McpRegistrar
             servers = new JsonObject();
             root["mcpServers"] = servers;
         }
-        servers[ServerName] = BuildEntry(t);
+        foreach (var s in Servers)
+            servers[s.Name] = BuildEntry(t, s);
         WriteRoot(path, root);
         AppLogger.Info($"MCP registered to {DisplayName(t)} at {path}");
     }
 
-    /// <summary>從該目標設定檔移除 etterms-serial。</summary>
+    /// <summary>從該目標設定檔移除所有 ETTerms MCP servers。</summary>
     public static void Unregister(McpTarget t)
     {
         var path = ConfigPath(t);
         if (!File.Exists(path)) return;
         var root = LoadRoot(path);
-        if (root["mcpServers"] is JsonObject servers && servers.Remove(ServerName))
+        if (root["mcpServers"] is JsonObject servers)
         {
-            WriteRoot(path, root);
-            AppLogger.Info($"MCP unregistered from {DisplayName(t)} at {path}");
+            bool changed = false;
+            foreach (var s in Servers)
+                changed |= servers.Remove(s.Name);
+            if (changed)
+            {
+                WriteRoot(path, root);
+                AppLogger.Info($"MCP unregistered from {DisplayName(t)} at {path}");
+            }
         }
     }
 
-    private static JsonObject BuildEntry(McpTarget t)
+    private static JsonObject BuildEntry(McpTarget t, McpServer server)
     {
-        var exe = ResolveServerExe();
+        var exe = ResolveServerExe(server);
         return t switch
         {
             // Claude Code：stdio server 需 type 欄位