@etm-professional-control/winccoa-mcp-server 1.2.0 → 1.3.0

package/.env.example

@@ -62,11 +62,31 @@ WINCCOA_FIELD=default
 # For production: Create your own project-specific instructions
 # WINCCOA_PROJECT_INSTRUCTIONS=javascript/mcpServer/project-instructions.md
 
+# ====================
+# PMON CONFIGURATION
+# ====================
+
+# Pmon TCP Connection Settings (optional - defaults to localhost:4999)
+# WINCCOA_PMON_HOST=localhost
+# WINCCOA_PMON_PORT=4999
+
+# Pmon Authentication (optional - leave empty for no authentication)
+# WINCCOA_PMON_USER=
+# WINCCOA_PMON_PASSWORD=
 
 # ====================
 # TOOLS CONFIGURATION
 # ====================
 
 # Tools to load (comma-separated list of relative paths without .js extension)
-# Available tools: datapoints/dp_basic, datapoints/dp_create, datapoints/dp_set, datapoints/dp_types
-TOOLS=datapoints/dp_basic,datapoints/dp_create,datapoints/dp_set,datapoints/dp_types
+# Available tools:
+#   - Datapoints: datapoints/dp_basic, datapoints/dp_create, datapoints/dp_set, datapoints/dp_types, datapoints/dp_type_create
+#   - Icons: icons/icon (for creating custom SVG icons for widget headers/footers)
+#   - OPC UA: opcua/opcua_connection, opcua/opcua_address
+#   - Common Config: common/common_query, common/common_set, common/common_delete
+#   - Alarms: alarms/alarm_set, alarms/alarm_delete
+#   - Archive: archive/archive_set, archive/archive_delete, archive/archive_query
+#   - Dashboards: dashboards/dashboard, dashboards/widget
+#   - PV Range: pv_range/pv_range_query, pv_range/pv_range_set, pv_range/pv_range_delete
+#   - Manager: manager/manager_list, manager/manager_add, manager/manager_remove, manager/manager_control, manager/manager_properties
+TOOLS=datapoints/dp_basic,datapoints/dp_create,datapoints/dp_set,datapoints/dp_types,datapoints/dp_type_create,icons/icon,opcua/opcua_connection,opcua/opcua_address,common/common_query,common/common_set,common/common_delete,alarms/alarm_set,alarms/alarm_delete,archive/archive_set,archive/archive_delete,archive/archive_query,dashboards/dashboard,dashboards/widget,pv_range/pv_range_query,pv_range/pv_range_set,pv_range/pv_range_delete

package/README.md

@@ -14,16 +14,24 @@ This Model Context Protocol (MCP) server connects AI assistants to WinCC OA SCAD
 - 
 ## ⚠️ Warning
 
-**This tool can modify datapoint values in your WinCC OA system.** Changes made through this MCP server directly affect your SCADA system and connected industrial processes. Use at your own risk and ensure proper testing in a safe environment before deploying to production systems.
+**This tool can modify your WinCC OA system configuration and runtime data.** Changes made through this MCP server directly affect your SCADA system and connected industrial processes. Use at your own risk and ensure proper testing in a safe environment before deploying to production systems.
 
-**To prevent write operations**, exclude these tools from your configuration:
-- `datapoints/dp_set` - Allows writing values to datapoints
-- `datapoints/dp_create` - Allows creating new datapoints
+**To prevent write operations to SCADA configuration and runtime data**, exclude these tool categories from your configuration:
+- **Datapoints**: `datapoints/dp_set`, `datapoints/dp_create`, `datapoints/dp_type_create`
+- **Alarms**: `alarms/alarm_set`, `alarms/alarm_delete`
+- **Archives**: `archive/archive_set`, `archive/archive_delete`
+- **Common Config**: `common/common_set`, `common/common_delete`
+- **PV Ranges**: `pv_range/pv_range_set`, `pv_range/pv_range_delete`
+- **Managers**: `manager/manager_control`, `manager/manager_add`, `manager/manager_remove`, `manager/manager_properties`
+- **Dashboards**: `dashboards/dashboard`, `dashboards/widget`
+- **OPC UA**: `opcua/opcua_connection`, `opcua/opcua_address`
+
+**Note**: Icon tools (`icons/icon`) create/delete SVG files but don't modify SCADA data.
 
 Example read-only configuration:
 ```env
 # Only include read operations
-TOOLS=datapoints/dp_basic,datapoints/dp_types
+TOOLS=datapoints/dp_basic,datapoints/dp_types,archive/archive_query,common/common_query,pv_range/pv_range_query,manager/manager_list,opcua/opcua_connection
 ```
 
 ## Prerequisites
@@ -87,8 +95,18 @@ MCP_API_TOKEN=your-secure-token-here
 # Choose industry context
 WINCCOA_FIELD=default  # or 'oil', 'transport'
 
-# Configure available tools  
-TOOLS=datapoints/dp_basic,datapoints/dp_set,datapoints/dp_types
+# Configure available tools (examples - see docs/TOOLS.md for complete list)
+# Full feature set
+TOOLS=datapoints/dp_basic,datapoints/dp_set,opcua/opcua_connection,dashboards/dashboard,manager/manager_list
+
+# Dashboard-focused setup
+# TOOLS=datapoints/dp_basic,dashboards/dashboard,dashboards/widget,icons/icon
+
+# Manager control setup
+# TOOLS=manager/manager_list,manager/manager_control,manager/manager_add
+
+# Read-only monitoring
+# TOOLS=datapoints/dp_basic,archive/archive_query,alarms/alarm_query,manager/manager_list
 ```
 
 ### 3. Start Server
@@ -150,11 +168,25 @@ This method uses `cmd` to properly handle paths with spaces in Windows.
 
 ## Features
 
-✅ **Secure API** - Token-based authentication  
-✅ **Industry Templates** - Pre-configured for Oil & Gas, Transportation  
-✅ **Custom Tools** - Extend with your own WinCC OA integrations  
-✅ **Project Rules** - Plant-specific AI guidance  
-✅ **Dynamic Loading** - Configure only needed tools  
+✅ **Secure API** - Token-based authentication
+✅ **Industry Templates** - Pre-configured for Oil & Gas, Transportation
+✅ **Custom Tools** - Extend with your own WinCC OA integrations
+✅ **Project Rules** - Plant-specific AI guidance
+✅ **Dynamic Loading** - Configure only needed tools
+
+### Available Tool Categories
+
+- **📊 Datapoints** - Read, write, and create datapoints and types
+- **🔗 OPC UA** - Connect to OPC UA servers and browse address spaces
+- **📈 Dashboards & Widgets** - Create and manage visualization dashboards
+- **🚨 Alarms** - Configure alarm thresholds and notifications
+- **📁 Archives** - Query and configure historical data storage
+- **⚙️ Manager Control** - Start, stop, and manage WinCC OA processes (Pmon)
+- **🔧 Common Config** - Set descriptions, aliases, formats, and units
+- **✓ PV Range Validation** - Define min/max value ranges
+- **🎨 Icons** - Create custom SVG icons and browse 1,400+ built-in Siemens IX icons
+
+See **[🔧 TOOLS.md](docs/TOOLS.md)** for complete tool documentation.  
 
 ## Support
 

package/build/config/server.config.d.ts

@@ -1,52 +1,18 @@
-export function loadSSLConfig(): {
-    cert: NonSharedBuffer & string;
-    key: NonSharedBuffer & string;
-    ca: NonSharedBuffer | undefined;
-} | null;
-export function validateConfig(): string[];
-export namespace serverConfig {
-    let mode: string;
-    namespace http {
-        let port: number;
-        let host: string;
-        namespace auth {
-            let enabled: boolean;
-            let type: string;
-            let token: string | undefined;
-            namespace jwt {
-                let enabled_1: boolean;
-                export { enabled_1 as enabled };
-                export let secret: string | undefined;
-                export let expiresIn: string;
-            }
-        }
-        namespace cors {
-            let enabled_2: boolean;
-            export { enabled_2 as enabled };
-            export let origins: string[];
-            export let credentials: boolean;
-        }
-        namespace ssl {
-            let enabled_3: boolean;
-            export { enabled_3 as enabled };
-            export let cert: string | undefined;
-            export let key: string | undefined;
-            export let ca: string | undefined;
-        }
-    }
-    namespace security {
-        namespace rateLimit {
-            let enabled_4: boolean;
-            export { enabled_4 as enabled };
-            export let windowMs: number;
-            export let max: number;
-        }
-        namespace ipFilter {
-            let enabled_5: boolean;
-            export { enabled_5 as enabled };
-            export let whitelist: string[];
-            export let blacklist: string[];
-        }
-    }
-}
+/**
+ * Server Deployment Configuration
+ *
+ * Configuration for HTTP/STDIO server modes, authentication, CORS, SSL, and security.
+ */
+import type { ServerConfig, SslCertificates } from '../types/index.js';
+export declare const serverConfig: ServerConfig;
+/**
+ * Helper function to load SSL certificates
+ * @returns SSL certificate data or null if SSL is disabled or loading fails
+ */
+export declare function loadSSLConfig(): SslCertificates | null;
+/**
+ * Validate configuration
+ * @returns Array of validation error messages (empty if valid)
+ */
+export declare function validateConfig(): string[];
 //# sourceMappingURL=server.config.d.ts.map

package/build/config/server.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.config.d.ts","sourceRoot":"","sources":["../../src/config/server.config.js"],"names":[],"mappings":"AAgEA;;;;SAcC;AAGD,2CAiBC"}
+{"version":3,"file":"server.config.d.ts","sourceRoot":"","sources":["../../src/config/server.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGvE,eAAO,MAAM,YAAY,EAAE,YAuD1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,GAAG,IAAI,CAmBtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAiBzC"}

package/build/config/server.config.js

@@ -1,9 +1,13 @@
+/**
+ * Server Deployment Configuration
+ *
+ * Configuration for HTTP/STDIO server modes, authentication, CORS, SSL, and security.
+ */
 import { readFileSync } from 'fs';
-import { join } from 'path';
 // Server deployment configuration
 export const serverConfig = {
     // Server mode configuration
-    mode: process.env.MCP_MODE || 'http', // 'http' or 'stdio'
+    mode: process.env.MCP_MODE || 'http',
     // HTTP server configuration
     http: {
         port: parseInt(process.env.MCP_HTTP_PORT || '3000'),
@@ -11,7 +15,7 @@ export const serverConfig = {
         // Authentication configuration
         auth: {
             enabled: true, // Always enabled for security
-            type: process.env.MCP_AUTH_TYPE || 'bearer', // 'bearer' or 'api-key'
+            type: process.env.MCP_AUTH_TYPE || 'bearer',
             token: process.env.MCP_API_TOKEN, // Required - no default
             // Additional auth options for future expansion
             jwt: {
@@ -48,14 +52,21 @@ export const serverConfig = {
             whitelist: process.env.IP_WHITELIST ? process.env.IP_WHITELIST.split(',') : [],
             blacklist: process.env.IP_BLACKLIST ? process.env.IP_BLACKLIST.split(',') : []
         }
-    },
+    }
 };
-// Helper function to load SSL certificates
+/**
+ * Helper function to load SSL certificates
+ * @returns SSL certificate data or null if SSL is disabled or loading fails
+ */
 export function loadSSLConfig() {
     const config = serverConfig.http.ssl;
     if (!config.enabled)
         return null;
     try {
+        if (!config.cert || !config.key) {
+            console.error('SSL enabled but cert or key path not configured');
+            return null;
+        }
         return {
             cert: readFileSync(config.cert),
             key: readFileSync(config.key),
@@ -67,7 +78,10 @@ export function loadSSLConfig() {
         return null;
     }
 }
-// Validate configuration
+/**
+ * Validate configuration
+ * @returns Array of validation error messages (empty if valid)
+ */
 export function validateConfig() {
     console.log('🔍 Starting configuration validation...');
     console.log('🔍 process.env.MCP_API_TOKEN:', process.env.MCP_API_TOKEN ? 'SET' : 'NOT SET');

package/build/config/server.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.config.js","sourceRoot":"","sources":["../../src/config/server.config.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.config.js","sourceRoot":"","sources":["../../src/config/server.config.ts"],"names":[],"mappings":"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"}

package/build/helpers/dashboards/DashboardManager.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Dashboard Manager
+ *
+ * Central class for managing dashboards and widgets in WinCC OA.
+ * Provides CRUD operations for dashboards and widgets.
+ */
+import type { WinccoaManager } from 'winccoa-manager';
+import { WidgetFactory } from './WidgetFactory.js';
+import { LayoutHelper } from './LayoutHelper.js';
+import type { DashboardConfig, DashboardInfo, WidgetIdentifier } from '../../types/dashboards/dashboard.js';
+import type { WidgetInstance } from '../../types/dashboards/schema.js';
+import type { WidgetConfig } from '../../types/dashboards/widgets.js';
+/**
+ * Dashboard Manager Class
+ */
+export declare class DashboardManager {
+    private winccoa;
+    private widgetFactory;
+    private layoutHelper;
+    constructor(winccoa: WinccoaManager);
+    /**
+     * Get the WidgetFactory instance (for registering custom widget types)
+     */
+    getWidgetFactory(): WidgetFactory;
+    /**
+     * Get the LayoutHelper instance
+     */
+    getLayoutHelper(): LayoutHelper;
+    /**
+     * Create a new dashboard
+     * @param config - Dashboard configuration (name, description, createdBy)
+     * @returns Dashboard datapoint name (e.g. "_Dashboard_000001")
+     */
+    createDashboard(config: DashboardConfig): Promise<string>;
+    /**
+     * Edit dashboard properties
+     * @param dashboardId - Dashboard datapoint name
+     * @param updates - Properties to update (name and/or description)
+     */
+    editDashboard(dashboardId: string, updates: Partial<DashboardConfig>): Promise<void>;
+    /**
+     * Delete a dashboard
+     * @param dashboardId - Dashboard datapoint name
+     */
+    deleteDashboard(dashboardId: string): Promise<void>;
+    /**
+     * List all dashboards
+     * @returns Array of dashboard information
+     */
+    listDashboards(): Promise<DashboardInfo[]>;
+    /**
+     * Add a widget to a dashboard
+     * @param dashboardId - Dashboard datapoint name
+     * @param config - Widget configuration
+     * @returns Widget ID (UUID)
+     */
+    addWidget(dashboardId: string, config: WidgetConfig): Promise<string>;
+    /**
+     * Edit a widget on a dashboard
+     * @param dashboardId - Dashboard datapoint name
+     * @param identifier - Widget identifier (by ID or index)
+     * @param updates - Widget configuration updates
+     */
+    editWidget(dashboardId: string, identifier: WidgetIdentifier, updates: Partial<WidgetConfig>): Promise<void>;
+    /**
+     * Delete a widget from a dashboard
+     * @param dashboardId - Dashboard datapoint name
+     * @param identifier - Widget identifier (by ID or index)
+     */
+    deleteWidget(dashboardId: string, identifier: WidgetIdentifier): Promise<void>;
+    /**
+     * List all widgets on a dashboard
+     * @param dashboardId - Dashboard datapoint name
+     * @returns Array of widget instances
+     */
+    listWidgets(dashboardId: string): Promise<WidgetInstance[]>;
+    /**
+     * Get next available dashboard number
+     * @returns Next dashboard number
+     */
+    private getNextDashboardNumber;
+    /**
+     * Get widgets from dashboard
+     * @param dashboardId - Dashboard datapoint name
+     * @returns Array of widget instances
+     */
+    private getWidgets;
+    /**
+     * Find widget index by identifier
+     * @param widgets - Array of widgets
+     * @param identifier - Widget identifier
+     * @returns Widget index or -1 if not found
+     */
+    private findWidgetIndex;
+    /**
+     * Validate widget configuration
+     * @param config - Widget configuration
+     */
+    private validateWidgetConfig;
+    /**
+     * Validate that datapoints exist
+     * @param config - Widget configuration
+     */
+    private validateDatapoints;
+    /**
+     * Get unit from datapoint configuration
+     * @param dpName - Datapoint name
+     * @returns Unit string or undefined
+     */
+    private getDatapointUnit;
+}
+//# sourceMappingURL=DashboardManager.d.ts.map

package/build/helpers/dashboards/DashboardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardManager.d.ts","sourceRoot":"","sources":["../../../src/helpers/dashboards/DashboardManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAIjB,MAAM,qCAAqC,CAAC;AAM7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,EAAE,cAAc;IAMnC;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,eAAe,IAAI,YAAY;IAM/B;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAmD/D;;;;OAIG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAiChD;;;;;OAKG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAsF3E;;;;;OAKG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IA8NhB;;;;OAIG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpF;;;;OAIG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAMjE;;;OAGG;YACW,sBAAsB;IAcpC;;;;OAIG;YACW,UAAU;IAUxB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;OAGG;YACW,kBAAkB;IAyBhC;;;;OAIG;YACW,gBAAgB;CAU/B"}