@mokoconsulting/mcp-windows 3.0.0

package/dist/tools/maintenance.js

@@ -0,0 +1,236 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tools: windows_updates (#59), windows_event_log (#60),
+ *        windows_restore_point (#61), windows_certificate_list (#62),
+ *        windows_performance_monitor (#63)
+ */
+import { z } from 'zod';
+import { runPowerShell } from '../shell.js';
+export function registerMaintenanceTools(server) {
+    server.tool('windows_updates', 'Check Windows Update status, pending updates, and recent history.', {
+        action: z.enum(['status', 'history']).default('status').describe('Check status or view history'),
+        limit: z.number().default(20).describe('Max history entries'),
+    }, async ({ action, limit }) => {
+        if (action === 'history') {
+            const ps = `
+$session = New-Object -ComObject Microsoft.Update.Session
+$searcher = $session.CreateUpdateSearcher()
+$count = $searcher.GetTotalHistoryCount()
+$history = $searcher.QueryHistory(0, [math]::Min($count, ${limit}))
+$history | ForEach-Object {
+  [PSCustomObject]@{
+    Date = $_.Date.ToString('yyyy-MM-dd HH:mm')
+    Title = $_.Title
+    Result = switch ($_.ResultCode) { 0 {'Not Started'} 1 {'In Progress'} 2 {'Succeeded'} 3 {'Succeeded with Errors'} 4 {'Failed'} 5 {'Aborted'} default {'Unknown'} }
+  }
+} | ConvertTo-Json -Depth 3 -Compress`;
+            const result = await runPowerShell(ps, { timeout: 30000 });
+            if (result.exitCode !== 0) {
+                return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+            }
+            if (!result.stdout) {
+                return { content: [{ type: 'text', text: 'No update history.' }] };
+            }
+            const entries = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+            const lines = entries.map((e) => `${e.Result.padEnd(10)}  ${e.Date}  ${(e.Title || '').slice(0, 70)}`);
+            return { content: [{ type: 'text', text: `Recent updates:\n${lines.join('\n')}` }] };
+        }
+        // Status
+        const ps = `
+$reboot = Test-Path 'HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\WindowsUpdate\\Auto Update\\RebootRequired'
+$lastCheck = (Get-ItemProperty -Path 'HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\WindowsUpdate\\Auto Update\\Results\\Detect' -Name LastSuccessTime -ErrorAction SilentlyContinue).LastSuccessTime
+[PSCustomObject]@{
+  RestartPending = $reboot
+  LastCheckTime = $lastCheck
+} | ConvertTo-Json -Compress`;
+        const result = await runPowerShell(ps, { timeout: 15000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        const info = JSON.parse(result.stdout);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Windows Update:\n  Restart pending: ${info.RestartPending}\n  Last check: ${info.LastCheckTime || 'Unknown'}`,
+                }],
+        };
+    });
+    server.tool('windows_event_log', 'Read Windows Event Log entries. Filter by log, level, source, or time.', {
+        log: z.string().default('System').describe('Log name (System, Application, Security, etc.)'),
+        level: z.enum(['Critical', 'Error', 'Warning', 'Information', 'All']).default('All').describe('Event level'),
+        source: z.string().optional().describe('Event source filter'),
+        limit: z.number().default(20).describe('Max entries'),
+        hours: z.number().optional().describe('Only events from last N hours'),
+    }, async ({ log, level, source, limit, hours }) => {
+        const levelMap = {
+            Critical: '1', Error: '2', Warning: '3', Information: '4',
+        };
+        const levelFilter = level !== 'All' ? `-Level ${levelMap[level]}` : '';
+        const sourceFilter = source ? `-ProviderName '${source.replace(/'/g, "''")}'` : '';
+        const timeFilter = hours ? `-After (Get-Date).AddHours(-${hours})` : '';
+        const ps = `
+Get-WinEvent -LogName '${log.replace(/'/g, "''")}' -MaxEvents ${limit} ${levelFilter ? `| Where-Object { $_.Level -eq ${levelMap[level]} }` : ''} -ErrorAction SilentlyContinue |
+  ${source ? `Where-Object { $_.ProviderName -like '*${source.replace(/'/g, "''")}*' } |` : ''}
+  ${hours ? `Where-Object { $_.TimeCreated -gt (Get-Date).AddHours(-${hours}) } |` : ''}
+  Select-Object -First ${limit} |
+  ForEach-Object {
+    [PSCustomObject]@{
+      Time = $_.TimeCreated.ToString('yyyy-MM-dd HH:mm:ss')
+      Level = $_.LevelDisplayName
+      Source = $_.ProviderName
+      EventId = $_.Id
+      Message = ($_.Message -split [char]10)[0].Substring(0, [math]::Min(($_.Message -split [char]10)[0].Length, 100))
+    }
+  } | ConvertTo-Json -Depth 3 -Compress`;
+        const result = await runPowerShell(ps, { timeout: 20000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        if (!result.stdout) {
+            return { content: [{ type: 'text', text: 'No events found.' }] };
+        }
+        const events = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+        const lines = events.map((e) => `${(e.Level || '').padEnd(12)}  ${e.Time}  ${String(e.EventId).padStart(5)}  ${(e.Source || '').padEnd(25).slice(0, 25)}  ${(e.Message || '').slice(0, 50)}`);
+        const header = `${'Level'.padEnd(12)}  ${'Time'.padEnd(19)}  ${'ID'.padStart(5)}  ${'Source'.padEnd(25)}  Message`;
+        return { content: [{ type: 'text', text: `${log} log:\n${header}\n${'─'.repeat(120)}\n${lines.join('\n')}` }] };
+    });
+    server.tool('windows_restore_point', 'List or create System Restore points.', {
+        action: z.enum(['list', 'create']).default('list').describe('Action'),
+        description: z.string().optional().describe('Description for new restore point'),
+    }, async ({ action, description }) => {
+        if (action === 'create') {
+            const desc = description || 'mcp_windows restore point';
+            const ps = `Checkpoint-Computer -Description '${desc.replace(/'/g, "''")}' -RestorePointType MODIFY_SETTINGS -ErrorAction Stop; "Restore point created: ${desc}"`;
+            const result = await runPowerShell(ps, { timeout: 60000 });
+            return { content: [{ type: 'text', text: result.stdout || result.stderr }], isError: result.exitCode !== 0 };
+        }
+        const ps = `
+try {
+  $points = Get-ComputerRestorePoint -ErrorAction Stop
+  if (-not $points) { Write-Output '[]'; return }
+  $points | ForEach-Object {
+    [PSCustomObject]@{
+      SequenceNumber = $_.SequenceNumber
+      Description = $_.Description
+      Type = switch ($_.RestorePointType) { 0 {'Application Install'} 1 {'Application Uninstall'} 10 {'Device Install'} 12 {'Modify Settings'} 13 {'Cancel'} default {'Other'} }
+      Date = $_.ConvertToDateTime($_.CreationTime).ToString('yyyy-MM-dd HH:mm')
+    }
+  } | ConvertTo-Json -Depth 3 -Compress
+} catch {
+  Write-Output "RESTORE_ERROR:$($_.Exception.Message)"
+}`;
+        const result = await runPowerShell(ps, { timeout: 15000 });
+        if (result.stdout?.startsWith('RESTORE_ERROR:')) {
+            const msg = result.stdout.replace('RESTORE_ERROR:', '');
+            return { content: [{ type: 'text', text: `System Restore: ${msg || 'Requires elevation or System Restore is disabled.'}` }] };
+        }
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr || 'Requires elevation.'}` }], isError: true };
+        }
+        if (!result.stdout || result.stdout === '[]') {
+            return { content: [{ type: 'text', text: 'No restore points found (System Restore may be disabled or requires elevation).' }] };
+        }
+        const points = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+        const lines = points.map((p) => `  #${p.SequenceNumber}  ${p.Date}  ${(p.Type || '').padEnd(20)}  ${p.Description}`);
+        return { content: [{ type: 'text', text: `System Restore points:\n${lines.join('\n')}` }] };
+    });
+    server.tool('windows_certificate_list', 'List certificates in the Windows certificate store.', {
+        store: z.string().default('Cert:\\CurrentUser\\My').describe('Certificate store path'),
+        expiring_days: z.number().optional().describe('Only show certs expiring within N days'),
+        filter: z.string().optional().describe('Filter by subject (substring)'),
+    }, async ({ store, expiring_days, filter }) => {
+        const expiryFilter = expiring_days
+            ? `| Where-Object { $_.NotAfter -lt (Get-Date).AddDays(${expiring_days}) -and $_.NotAfter -gt (Get-Date) }`
+            : '';
+        const nameFilter = filter
+            ? `| Where-Object { $_.Subject -like '*${filter.replace(/'/g, "''")}*' }`
+            : '';
+        // Map store path to .NET enums
+        // Cert:\CurrentUser\My -> CurrentUser, My
+        const storeMatch = store.match(/Cert:\\\\?(CurrentUser|LocalMachine)\\\\?(\w+)/i);
+        const storeLocation = storeMatch ? storeMatch[1] : 'CurrentUser';
+        const storeName = storeMatch ? storeMatch[2] : 'My';
+        const ps = `
+$store = New-Object System.Security.Cryptography.X509Certificates.X509Store('${storeName}', '${storeLocation}')
+$store.Open('ReadOnly')
+$certs = $store.Certificates
+${expiring_days ? `$certs = $certs | Where-Object { $_.NotAfter -lt (Get-Date).AddDays(${expiring_days}) -and $_.NotAfter -gt (Get-Date) }` : ''}
+${filter ? `$certs = $certs | Where-Object { $_.Subject -like '*${filter.replace(/'/g, "''")}*' }` : ''}
+$certs | ForEach-Object {
+  [PSCustomObject]@{
+    Subject = $_.Subject
+    Issuer = $_.Issuer
+    Thumbprint = $_.Thumbprint
+    Expires = $_.NotAfter.ToString('yyyy-MM-dd')
+    KeyUsage = ($_.Extensions | Where-Object { $_ -is [System.Security.Cryptography.X509Certificates.X509EnhancedKeyUsageExtension] } | ForEach-Object { ($_.EnhancedKeyUsages | ForEach-Object { $_.FriendlyName }) -join ', ' })
+  }
+} | ConvertTo-Json -Depth 3 -Compress
+$store.Close()`;
+        const result = await runPowerShell(ps, { timeout: 15000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        if (!result.stdout) {
+            return { content: [{ type: 'text', text: 'No certificates found.' }] };
+        }
+        const certs = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+        const lines = certs.map((c) => `  ${c.Expires}  ${(c.Thumbprint || '').slice(0, 16)}...  ${(c.Subject || '').slice(0, 60)}`);
+        const header = `  ${'Expires'.padEnd(10)}  ${'Thumbprint'.padEnd(19)}  Subject`;
+        return { content: [{ type: 'text', text: `${store}\n${header}\n${'─'.repeat(90)}\n${lines.join('\n')}\n\n${certs.length} certificates` }] };
+    });
+    server.tool('windows_performance_monitor', 'Get real-time system performance: CPU per core, RAM, disk I/O, network throughput, top processes.', {}, async () => {
+        const ps = `
+$cpu = Get-CimInstance Win32_Processor | Select-Object -First 1
+$os = Get-CimInstance Win32_OperatingSystem
+$cs = Get-CimInstance Win32_ComputerSystem
+$perfDisk = Get-CimInstance Win32_PerfFormattedData_PerfDisk_LogicalDisk -Filter "Name='_Total'" -ErrorAction SilentlyContinue
+$perfNet = Get-CimInstance Win32_PerfFormattedData_Tcpip_NetworkInterface -ErrorAction SilentlyContinue | Select-Object -First 1
+
+$topCPU = Get-Process | Sort-Object CPU -Descending | Select-Object -First 5 | ForEach-Object {
+  [PSCustomObject]@{ Name = $_.ProcessName; PID = $_.Id; CPU = [math]::Round($_.CPU, 1); MemMB = [math]::Round($_.WorkingSet64 / 1MB, 1) }
+}
+$topMem = Get-Process | Sort-Object WorkingSet64 -Descending | Select-Object -First 5 | ForEach-Object {
+  [PSCustomObject]@{ Name = $_.ProcessName; PID = $_.Id; MemMB = [math]::Round($_.WorkingSet64 / 1MB, 1) }
+}
+
+[PSCustomObject]@{
+  CPUUsage = "$([math]::Round($cpu.LoadPercentage, 0))%"
+  CPUCores = $cpu.NumberOfLogicalProcessors
+  RAMTotalGB = [math]::Round($cs.TotalPhysicalMemory / 1GB, 1)
+  RAMUsedGB = [math]::Round(($cs.TotalPhysicalMemory - $os.FreePhysicalMemory * 1KB) / 1GB, 1)
+  RAMUsedPct = [math]::Round(($cs.TotalPhysicalMemory - $os.FreePhysicalMemory * 1KB) / $cs.TotalPhysicalMemory * 100, 1)
+  DiskReadBps = if ($perfDisk) { "$([math]::Round($perfDisk.DiskReadBytesPersec / 1MB, 2)) MB/s" } else { 'N/A' }
+  DiskWriteBps = if ($perfDisk) { "$([math]::Round($perfDisk.DiskWriteBytesPersec / 1MB, 2)) MB/s" } else { 'N/A' }
+  NetSentBps = if ($perfNet) { "$([math]::Round($perfNet.BytesSentPersec / 1MB, 2)) MB/s" } else { 'N/A' }
+  NetRecvBps = if ($perfNet) { "$([math]::Round($perfNet.BytesReceivedPersec / 1MB, 2)) MB/s" } else { 'N/A' }
+  TopCPU = $topCPU
+  TopMem = $topMem
+} | ConvertTo-Json -Depth 4 -Compress`;
+        const result = await runPowerShell(ps, { timeout: 30000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        const p = JSON.parse(result.stdout);
+        const topCpu = Array.isArray(p.TopCPU) ? p.TopCPU : [p.TopCPU].filter(Boolean);
+        const topMem = Array.isArray(p.TopMem) ? p.TopMem : [p.TopMem].filter(Boolean);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `CPU: ${p.CPUUsage} (${p.CPUCores} threads)`,
+                        `RAM: ${p.RAMUsedGB}/${p.RAMTotalGB} GB (${p.RAMUsedPct}%)`,
+                        `Disk: Read ${p.DiskReadBps} / Write ${p.DiskWriteBps}`,
+                        `Net:  Send ${p.NetSentBps} / Recv ${p.NetRecvBps}`,
+                        '',
+                        'Top by CPU:',
+                        ...topCpu.map((t) => `  ${String(t.PID).padStart(6)}  ${t.Name.padEnd(20)}  ${String(t.CPU).padStart(8)}s  ${String(t.MemMB).padStart(8)} MB`),
+                        '',
+                        'Top by Memory:',
+                        ...topMem.map((t) => `  ${String(t.PID).padStart(6)}  ${t.Name.padEnd(20)}  ${String(t.MemMB).padStart(8)} MB`),
+                    ].join('\n'),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=maintenance.js.map

package/dist/tools/netstat.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerNetstatTools(server: McpServer): void;
+//# sourceMappingURL=netstat.d.ts.map

package/dist/tools/netstat.js

@@ -0,0 +1,56 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tool: windows_network_connections (#23)
+ */
+import { z } from 'zod';
+import { runPowerShell } from '../shell.js';
+export function registerNetstatTools(server) {
+    server.tool('windows_network_connections', 'List active TCP/UDP network connections (like netstat). Shows local/remote address, state, and owning process.', {
+        state: z.enum(['all', 'listen', 'established', 'time_wait', 'close_wait']).default('all').describe('Filter by state'),
+        port: z.number().optional().describe('Filter by port number'),
+        process_name: z.string().optional().describe('Filter by process name'),
+        limit: z.number().default(50).describe('Max results'),
+    }, async ({ state, port, process_name, limit }) => {
+        const stateMap = {
+            listen: "| Where-Object { $_.State -eq 'Listen' }",
+            established: "| Where-Object { $_.State -eq 'Established' }",
+            time_wait: "| Where-Object { $_.State -eq 'TimeWait' }",
+            close_wait: "| Where-Object { $_.State -eq 'CloseWait' }",
+            all: '',
+        };
+        const portFilter = port
+            ? `| Where-Object { $_.LocalPort -eq ${port} -or $_.RemotePort -eq ${port} }`
+            : '';
+        const procFilter = process_name
+            ? `| Where-Object { $procName -like '*${process_name.replace(/'/g, "''")}*' }`
+            : '';
+        const ps = `
+Get-NetTCPConnection -ErrorAction SilentlyContinue ${stateMap[state]} ${portFilter} | ForEach-Object {
+  $proc = Get-Process -Id $_.OwningProcess -ErrorAction SilentlyContinue
+  $procName = if ($proc) { $proc.ProcessName } else { '?' }
+  [PSCustomObject]@{
+    Proto = 'TCP'
+    LocalAddr = "$($_.LocalAddress):$($_.LocalPort)"
+    RemoteAddr = "$($_.RemoteAddress):$($_.RemotePort)"
+    State = $_.State.ToString()
+    PID = $_.OwningProcess
+    Process = $procName
+  }
+} ${procFilter} | Select-Object -First ${limit} | ConvertTo-Json -Depth 3 -Compress`;
+        const result = await runPowerShell(ps, { timeout: 15000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        if (!result.stdout) {
+            return { content: [{ type: 'text', text: 'No connections found.' }] };
+        }
+        const conns = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+        const lines = conns.map((c) => `${c.Proto}  ${c.LocalAddr.padEnd(22)}  ${c.RemoteAddr.padEnd(22)}  ${c.State.padEnd(12)}  ${String(c.PID).padStart(6)}  ${c.Process}`);
+        const header = `Proto  ${'Local Address'.padEnd(22)}  ${'Remote Address'.padEnd(22)}  ${'State'.padEnd(12)}  ${'PID'.padStart(6)}  Process`;
+        return {
+            content: [{ type: 'text', text: `${header}\n${'─'.repeat(100)}\n${lines.join('\n')}\n\n${conns.length} connections` }],
+        };
+    });
+}
+//# sourceMappingURL=netstat.js.map

package/dist/tools/network.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerNetworkTools(server: McpServer): void;
+//# sourceMappingURL=network.d.ts.map

package/dist/tools/network.js

@@ -0,0 +1,70 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tool: windows_network_info (#22)
+ */
+import { runPowerShell } from '../shell.js';
+export function registerNetworkTools(server) {
+    server.tool('windows_network_info', 'Get network configuration: adapters, IPs, DNS, gateway, Wi-Fi status, and connectivity.', {}, async () => {
+        const ps = `
+$adapters = Get-NetAdapter | Where-Object { $_.Status -eq 'Up' } | ForEach-Object {
+  $ipInfo = Get-NetIPAddress -InterfaceIndex $_.ifIndex -AddressFamily IPv4 -ErrorAction SilentlyContinue
+  $dns = (Get-DnsClientServerAddress -InterfaceIndex $_.ifIndex -AddressFamily IPv4 -ErrorAction SilentlyContinue).ServerAddresses
+  $gw = (Get-NetRoute -InterfaceIndex $_.ifIndex -DestinationPrefix '0.0.0.0/0' -ErrorAction SilentlyContinue).NextHop
+  [PSCustomObject]@{
+    Name = $_.Name
+    Description = $_.InterfaceDescription
+    Type = $_.MediaType
+    Status = $_.Status
+    Speed = $_.LinkSpeed
+    MAC = $_.MacAddress
+    IP = if ($ipInfo) { $ipInfo.IPAddress -join ', ' } else { 'N/A' }
+    Subnet = if ($ipInfo) { $ipInfo.PrefixLength -join ', ' } else { 'N/A' }
+    Gateway = if ($gw) { $gw -join ', ' } else { 'N/A' }
+    DNS = if ($dns) { $dns -join ', ' } else { 'N/A' }
+  }
+}
+
+# Wi-Fi info
+$wifi = $null
+try {
+  $wifiProfile = netsh wlan show interfaces 2>$null
+  if ($wifiProfile) {
+    $ssid = ($wifiProfile | Select-String 'SSID\s+:' | Select-Object -First 1) -replace '.*:\s*',''
+    $signal = ($wifiProfile | Select-String 'Signal' | Select-Object -First 1) -replace '.*:\s*',''
+    $auth = ($wifiProfile | Select-String 'Authentication' | Select-Object -First 1) -replace '.*:\s*',''
+    $wifi = [PSCustomObject]@{ SSID = $ssid.Trim(); Signal = $signal.Trim(); Security = $auth.Trim() }
+  }
+} catch {}
+
+# Connectivity
+$connected = Test-Connection -ComputerName 8.8.8.8 -Count 1 -Quiet -ErrorAction SilentlyContinue
+
+[PSCustomObject]@{
+  Adapters = $adapters
+  WiFi = $wifi
+  InternetConnected = $connected
+} | ConvertTo-Json -Depth 4 -Compress`;
+        const result = await runPowerShell(ps, { timeout: 15000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        const info = JSON.parse(result.stdout);
+        const lines = [];
+        lines.push(`Internet: ${info.InternetConnected ? 'Connected' : 'Disconnected'}`);
+        if (info.WiFi) {
+            lines.push(`Wi-Fi: ${info.WiFi.SSID} (${info.WiFi.Signal}, ${info.WiFi.Security})`);
+        }
+        lines.push('');
+        lines.push('Adapters:');
+        const adapters = Array.isArray(info.Adapters) ? info.Adapters : [info.Adapters];
+        for (const a of adapters.filter(Boolean)) {
+            lines.push(`  ${a.Name} (${a.Description})`);
+            lines.push(`    IP: ${a.IP}/${a.Subnet}  Gateway: ${a.Gateway}`);
+            lines.push(`    DNS: ${a.DNS}`);
+            lines.push(`    MAC: ${a.MAC}  Speed: ${a.Speed}`);
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    });
+}
+//# sourceMappingURL=network.js.map

package/dist/tools/notification.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerNotificationTools(server: McpServer): void;
+//# sourceMappingURL=notification.d.ts.map

package/dist/tools/notification.js

@@ -0,0 +1,41 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tool: windows_notification_send (#20)
+ */
+import { z } from 'zod';
+import { runPowerShell } from '../shell.js';
+export function registerNotificationTools(server) {
+    server.tool('windows_notification_send', 'Send a Windows toast notification with title, body, and optional icon.', {
+        title: z.string().describe('Notification title'),
+        body: z.string().describe('Notification body text'),
+        icon: z.string().optional().describe('Path to icon file (optional)'),
+        sound: z.boolean().default(true).describe('Play notification sound'),
+    }, async ({ title, body, icon, sound }) => {
+        const iconParam = icon
+            ? `$notify.Icon = [System.Drawing.Icon]::ExtractAssociatedIcon('${icon.replace(/'/g, "''")}');`
+            : `$notify.Icon = [System.Drawing.SystemIcons]::Information;`;
+        const ps = `
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+$notify = New-Object System.Windows.Forms.NotifyIcon
+${iconParam}
+$notify.Visible = $true
+$notify.BalloonTipTitle = '${title.replace(/'/g, "''")}'
+$notify.BalloonTipText = '${body.replace(/'/g, "''")}'
+$notify.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::Info
+$notify.ShowBalloonTip(5000)
+
+# Keep alive briefly so notification displays
+Start-Sleep -Milliseconds 100
+$notify.Dispose()
+"Notification sent: ${title.replace(/"/g, '\\"')}"`;
+        const result = await runPowerShell(ps, { timeout: 10000 });
+        return {
+            content: [{ type: 'text', text: result.stdout || result.stderr }],
+            isError: result.exitCode !== 0,
+        };
+    });
+}
+//# sourceMappingURL=notification.js.map

package/dist/tools/power.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPowerTools(server: McpServer): void;
+//# sourceMappingURL=power.d.ts.map

package/dist/tools/power.js

@@ -0,0 +1,104 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tools: windows_power_get (#12), windows_power_action (#13)
+ */
+import { z } from 'zod';
+import { runPowerShell } from '../shell.js';
+export function registerPowerTools(server) {
+    server.tool('windows_power_get', 'Get power state: battery level, AC/battery, power plan, screen/sleep timeouts.', {}, async () => {
+        const ps = `
+$battery = Get-CimInstance Win32_Battery -ErrorAction SilentlyContinue
+$plan = powercfg /getactivescheme 2>$null
+$planName = if ($plan) { ($plan -replace '^.*\\((.*)\\).*$','$1').Trim() } else { 'Unknown' }
+
+# Get timeout values
+$acScreen = (powercfg /query SCHEME_CURRENT SUB_VIDEO VIDEOIDLE 2>$null | Select-String 'Current AC Power Setting Index' | ForEach-Object { ($_ -split '0x')[1] }) -as [int]
+$dcScreen = (powercfg /query SCHEME_CURRENT SUB_VIDEO VIDEOIDLE 2>$null | Select-String 'Current DC Power Setting Index' | ForEach-Object { ($_ -split '0x')[1] }) -as [int]
+$acSleep = (powercfg /query SCHEME_CURRENT SUB_SLEEP STANDBYIDLE 2>$null | Select-String 'Current AC Power Setting Index' | ForEach-Object { ($_ -split '0x')[1] }) -as [int]
+$dcSleep = (powercfg /query SCHEME_CURRENT SUB_SLEEP STANDBYIDLE 2>$null | Select-String 'Current DC Power Setting Index' | ForEach-Object { ($_ -split '0x')[1] }) -as [int]
+
+[PSCustomObject]@{
+  HasBattery = $null -ne $battery
+  BatteryPct = if ($battery) { $battery.EstimatedChargeRemaining } else { $null }
+  Charging = if ($battery) { $battery.BatteryStatus -eq 2 } else { $null }
+  ACPower = if ($battery) { $battery.BatteryStatus -eq 2 -or $battery.BatteryStatus -eq 6 } else { $true }
+  TimeRemaining = if ($battery -and $battery.EstimatedRunTime -and $battery.EstimatedRunTime -lt 71582788) { "$([math]::Floor($battery.EstimatedRunTime / 60))h $($battery.EstimatedRunTime % 60)m" } else { $null }
+  PowerPlan = $planName
+  ScreenTimeout_AC = if ($acScreen) { "$([math]::Floor($acScreen / 60))m" } else { 'Never' }
+  ScreenTimeout_DC = if ($dcScreen) { "$([math]::Floor($dcScreen / 60))m" } else { 'Never' }
+  SleepTimeout_AC = if ($acSleep) { "$([math]::Floor($acSleep / 60))m" } else { 'Never' }
+  SleepTimeout_DC = if ($dcSleep) { "$([math]::Floor($dcSleep / 60))m" } else { 'Never' }
+} | ConvertTo-Json -Compress`;
+        const result = await runPowerShell(ps, { timeout: 30000 });
+        if (result.exitCode !== 0) {
+            return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+        }
+        const info = JSON.parse(result.stdout);
+        const lines = [];
+        if (info.HasBattery) {
+            const icon = info.Charging ? '🔌' : '🔋';
+            lines.push(`${icon} Battery: ${info.BatteryPct}%${info.Charging ? ' (charging)' : ''}`);
+            if (info.TimeRemaining)
+                lines.push(`Estimated remaining: ${info.TimeRemaining}`);
+        }
+        else {
+            lines.push(`AC Power (no battery)`);
+        }
+        lines.push(`Power Plan: ${info.PowerPlan}`);
+        lines.push(``);
+        lines.push(`Screen timeout: ${info.ScreenTimeout_AC} (AC) / ${info.ScreenTimeout_DC} (battery)`);
+        lines.push(`Sleep timeout: ${info.SleepTimeout_AC} (AC) / ${info.SleepTimeout_DC} (battery)`);
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    });
+    server.tool('windows_power_action', 'Execute power actions: sleep, hibernate, lock, shutdown, restart, or switch power plan.', {
+        action: z.enum(['sleep', 'hibernate', 'lock', 'shutdown', 'restart', 'logoff', 'plan']).describe('Power action'),
+        delay: z.number().optional().describe('Delay in seconds (for shutdown/restart)'),
+        cancel: z.boolean().optional().describe('Cancel a scheduled shutdown/restart'),
+        plan: z.enum(['balanced', 'performance', 'powersaver']).optional().describe('Power plan to switch to (when action=plan)'),
+    }, async ({ action, delay, cancel, plan }) => {
+        if (cancel) {
+            const result = await runPowerShell('shutdown /a 2>&1; "Scheduled shutdown cancelled"');
+            return { content: [{ type: 'text', text: result.stdout || result.stderr }] };
+        }
+        let ps;
+        const delayArg = delay ? `/t ${delay}` : '';
+        switch (action) {
+            case 'sleep':
+                ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Application]::SetSuspendState('Suspend', $false, $false); "Sleeping..."`;
+                break;
+            case 'hibernate':
+                ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Application]::SetSuspendState('Hibernate', $false, $false); "Hibernating..."`;
+                break;
+            case 'lock':
+                ps = `rundll32.exe user32.dll,LockWorkStation; "Workstation locked"`;
+                break;
+            case 'shutdown':
+                ps = `shutdown /s /f ${delayArg}; "Shutdown initiated${delay ? ` in ${delay}s` : ''}"`;
+                break;
+            case 'restart':
+                ps = `shutdown /r /f ${delayArg}; "Restart initiated${delay ? ` in ${delay}s` : ''}"`;
+                break;
+            case 'logoff':
+                ps = `shutdown /l; "Logging off..."`;
+                break;
+            case 'plan':
+                if (!plan) {
+                    return { content: [{ type: 'text', text: 'Specify a plan: balanced, performance, or powersaver' }], isError: true };
+                }
+                const planGuids = {
+                    balanced: '381b4222-f694-41f0-9685-ff5bb260df2e',
+                    performance: '8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c',
+                    powersaver: 'a1841308-3541-4fab-bc81-f71556f20b4a',
+                };
+                ps = `powercfg /setactive ${planGuids[plan]}; $p = powercfg /getactivescheme; "Switched to: $($p -replace '^.*\\((.*)\\).*$','$1')"`;
+                break;
+        }
+        const result = await runPowerShell(ps, { timeout: 30000 });
+        return {
+            content: [{ type: 'text', text: result.stdout || result.stderr }],
+            isError: result.exitCode !== 0,
+        };
+    });
+}
+//# sourceMappingURL=power.js.map

package/dist/tools/printer.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrinterTools(server: McpServer): void;
+//# sourceMappingURL=printer.d.ts.map

package/dist/tools/printer.js

@@ -0,0 +1,97 @@
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * Tool: windows_printer_list (#50)
+ */
+import { z } from 'zod';
+import { runPowerShell } from '../shell.js';
+export function registerPrinterTools(server) {
+    server.tool('windows_printer_list', 'List printers, show print queues, set default, or clear a queue.', {
+        action: z.enum(['list', 'queue', 'set_default', 'clear_queue']).default('list').describe('Action'),
+        printer: z.string().optional().describe('Printer name (for queue/set_default/clear_queue)'),
+    }, async ({ action, printer }) => {
+        switch (action) {
+            case 'list': {
+                const ps = `
+Get-Printer -ErrorAction SilentlyContinue | ForEach-Object {
+  $default = if ((Get-CimInstance Win32_Printer -Filter "Name='$($_.Name.Replace("'","''"))'" -ErrorAction SilentlyContinue).Default) { $true } else { $false }
+  [PSCustomObject]@{
+    Name = $_.Name
+    Status = $_.PrinterStatus
+    Type = $_.Type
+    Port = $_.PortName
+    Driver = $_.DriverName
+    Default = $default
+    Shared = $_.Shared
+  }
+} | ConvertTo-Json -Depth 3 -Compress`;
+                const result = await runPowerShell(ps, { timeout: 45000 });
+                if (result.exitCode !== 0) {
+                    return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+                }
+                if (!result.stdout) {
+                    return { content: [{ type: 'text', text: 'No printers found.' }] };
+                }
+                const printers = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+                const lines = printers.map((p) => {
+                    const def = p.Default ? ' *' : '  ';
+                    return `${def} ${(p.Name || '').padEnd(35).slice(0, 35)}  ${(p.Driver || '').padEnd(25).slice(0, 25)}  ${p.Port || ''}`;
+                });
+                const header = `   ${'Name'.padEnd(35)}  ${'Driver'.padEnd(25)}  Port`;
+                return {
+                    content: [{ type: 'text', text: `${header}\n${'─'.repeat(80)}\n${lines.join('\n')}\n\n${printers.length} printers (* = default)` }],
+                };
+            }
+            case 'queue': {
+                if (!printer) {
+                    return { content: [{ type: 'text', text: 'Queue requires printer name.' }], isError: true };
+                }
+                const ps = `
+Get-PrintJob -PrinterName '${printer.replace(/'/g, "''")}' -ErrorAction Stop | ForEach-Object {
+  [PSCustomObject]@{
+    Id = $_.Id
+    Document = $_.DocumentName
+    Status = $_.JobStatus
+    Pages = $_.TotalPages
+    Size = "$([math]::Round($_.Size / 1KB, 1)) KB"
+    Submitted = $_.SubmittedTime.ToString('yyyy-MM-dd HH:mm')
+  }
+} | ConvertTo-Json -Depth 3 -Compress`;
+                const result = await runPowerShell(ps, { timeout: 10000 });
+                if (result.exitCode !== 0) {
+                    return { content: [{ type: 'text', text: `Error: ${result.stderr}` }], isError: true };
+                }
+                if (!result.stdout) {
+                    return { content: [{ type: 'text', text: `Print queue for "${printer}" is empty.` }] };
+                }
+                const jobs = Array.isArray(JSON.parse(result.stdout)) ? JSON.parse(result.stdout) : [JSON.parse(result.stdout)];
+                const lines = jobs.map((j) => `  #${j.Id}  ${(j.Document || '').padEnd(30).slice(0, 30)}  ${(j.Status || '').padEnd(12)}  ${j.Pages} pg  ${j.Size}`);
+                return { content: [{ type: 'text', text: `Queue for "${printer}":\n${lines.join('\n')}` }] };
+            }
+            case 'set_default': {
+                if (!printer) {
+                    return { content: [{ type: 'text', text: 'set_default requires printer name.' }], isError: true };
+                }
+                const ps = `
+$p = Get-CimInstance Win32_Printer -Filter "Name='${printer.replace(/'/g, "''")}'" -ErrorAction Stop
+Invoke-CimMethod -InputObject $p -MethodName SetDefaultPrinter | Out-Null
+"Default printer set to: ${printer}"`;
+                const result = await runPowerShell(ps, { timeout: 10000 });
+                return { content: [{ type: 'text', text: result.stdout || result.stderr }] };
+            }
+            case 'clear_queue': {
+                if (!printer) {
+                    return { content: [{ type: 'text', text: 'clear_queue requires printer name.' }], isError: true };
+                }
+                const ps = `
+$jobs = Get-PrintJob -PrinterName '${printer.replace(/'/g, "''")}' -ErrorAction Stop
+$count = @($jobs).Count
+$jobs | Remove-PrintJob -ErrorAction SilentlyContinue
+"Cleared $count job(s) from ${printer}"`;
+                const result = await runPowerShell(ps, { timeout: 10000 });
+                return { content: [{ type: 'text', text: result.stdout || result.stderr }] };
+            }
+        }
+    });
+}
+//# sourceMappingURL=printer.js.map

package/dist/tools/process.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProcessTools(server: McpServer): void;
+//# sourceMappingURL=process.d.ts.map