node-opcua-modeler-mcp-server 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
5
5
  [![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
6
6
 
7
- An [MCP server](https://modelcontextprotocol.io) that gives AI agents access to the **OPC UA companion specification type system** — 589 types across 22 industrial namespaces, plus 1,533 engineering units.
7
+ An [MCP server](https://modelcontextprotocol.io) that gives AI agents access to the **OPC UA companion specification type system** — 589 types across 22 industrial namespaces, plus 1,533 engineering units — and lets agents **validate, generate, and reverse-engineer** OPC UA information models.
8
8
 
9
9
  Built on [node-opcua](https://github.com/node-opcua/node-opcua), the most widely used OPC UA stack for Node.js.
10
10
 
@@ -29,12 +29,17 @@ Add to your `claude_desktop_config.json`:
29
29
  "mcpServers": {
30
30
  "opcua-modeler": {
31
31
  "command": "npx",
32
- "args": ["-y", "node-opcua-modeler-mcp-server"]
32
+ "args": ["-y", "node-opcua-modeler-mcp-server"],
33
+ "env": {
34
+ "OPCUA_MODELER_API_KEY": "stfv_your_api_key_here"
35
+ }
33
36
  }
34
37
  }
35
38
  }
36
39
  ```
37
40
 
41
+ > **Note:** The API key is optional for discovery tools (offline) and `opcua_model_validate` (5 free calls/day). It is required for `opcua_model_generate` and `opcua_model_reverse`. Get a free key at [opcua-modeler.sterfive.com](https://opcua-modeler.sterfive.com/settings/api-keys).
42
+
38
43
  ### With any MCP client
39
44
 
40
45
  ```bash
@@ -132,6 +137,48 @@ Find the official UNECE Rec. 20 engineering unit symbol. Supports fuzzy matching
132
137
  ← { "symbol": "bar", "matchType": "exact", "confidence": 1 }
133
138
  ```
134
139
 
140
+ ### `opcua_model_validate` ☁️
141
+
142
+ Validate an OPC UA YAML model for correctness. Returns diagnostics with severity, codes, messages, and line numbers. Works without an API key (limited to 5 calls/day).
143
+
144
+ ```
145
+ → opcua_model_validate({ yaml: "namespaces:\n di:\n..." })
146
+ ← {
147
+ "valid": true,
148
+ "diagnostics": [
149
+ { "severity": "warning", "code": "W001", "message": "...", "line": 42 }
150
+ ]
151
+ }
152
+ ```
153
+
154
+ ### `opcua_model_generate` ☁️
155
+
156
+ Generate OPC UA NodeSet2.xml and Symbols.CSV from a validated YAML model. Returns base64-encoded artifacts. Requires an API key.
157
+
158
+ ```
159
+ → opcua_model_generate({ yaml: "namespaces:\n di:\n...", include_docs: false })
160
+ ← {
161
+ "valid": true,
162
+ "artifacts": {
163
+ "nodeset2_xml": "PD94bWwg...",
164
+ "symbols_csv": "bmFtZSxu..."
165
+ },
166
+ "diagnostics": []
167
+ }
168
+ ```
169
+
170
+ ### `opcua_model_reverse` ☁️
171
+
172
+ Reverse-engineer a NodeSet2.xml file back into the YAML DSL format. Requires an API key.
173
+
174
+ ```
175
+ → opcua_model_reverse({ xml: "<?xml version=..." })
176
+ ← {
177
+ "yaml": "namespaces:\n di:\n...",
178
+ "diagnostics": []
179
+ }
180
+ ```
181
+
135
182
  ## Coverage
136
183
 
137
184
  ### Companion Specifications (25)
@@ -167,19 +214,23 @@ Find the official UNECE Rec. 20 engineering unit symbol. Supports fuzzy matching
167
214
  The server ships with a pre-generated `catalog.json` containing all type information extracted from OPC Foundation's official NodeSet2.xml files via [node-opcua](https://github.com/node-opcua/node-opcua). All queries are answered from this static catalog — **no network required, no API key needed**.
168
215
 
169
216
  ```
170
- ┌─────────────────────────────────────────┐
171
- │ node-opcua-modeler-mcp-server │
172
- │ │
173
- │ ┌─────────────────────────────────┐ │
174
- │ │ catalog.json (1.7 MB) │ │
175
- │ │ • 25 companion spec registries │ │
176
- │ │ • 589 type summaries + details │ │
177
- │ │ • 1,533 engineering units │ │
178
- │ └─────────────────────────────────┘ │
179
- │ │
180
- │ 6 MCP tools → query the catalog │
181
- │ stdio transport (JSON-RPC) │
182
- └─────────────────────────────────────────┘
217
+ ┌──────────────────────────────────────────────────┐
218
+ │ node-opcua-modeler-mcp-server │
219
+ │ │
220
+ │ LOCAL TOOLS (offline, free) │
221
+ │ ┌────────────────────────────────────────┐ │
222
+ │ │ catalog.json (1.7 MB) │ │
223
+ │ │ • 25 companion spec registries │ │
224
+ │ │ • 589 type summaries + details │ │
225
+ │ │ • 1,533 engineering units │ │
226
+ │ └────────────────────────────────────────┘ │
227
+ │ 6 tools → query the catalog │
228
+ │ │
229
+ │ CLOUD TOOLS (via api.opcua-modeler.sterfive.io) │
230
+ │ 3 tools → validate / generate / reverse │
231
+ │ │
232
+ │ stdio transport (JSON-RPC) │
233
+ └──────────────────────────────────────────────────┘
183
234
  ```
184
235
 
185
236
  ## Use Cases
@@ -0,0 +1,41 @@
1
+ /**
2
+ * ==========================================================================
3
+ * OPC UA Modeler — Cloud API Client
4
+ *
5
+ * Thin HTTP wrapper for proxying MCP tool calls to the Sterfive SaaS API.
6
+ * ZERO proprietary dependencies — only native fetch.
7
+ *
8
+ * Configuration via environment variables:
9
+ * OPCUA_MODELER_API_URL — Base URL (default: https://api.opcua-modeler.sterfive.io)
10
+ * OPCUA_MODELER_API_KEY — API key (stfv_...) for authenticated endpoints
11
+ *
12
+ * IMPORTANT: Never use console.log() — stdout is reserved for JSON-RPC.
13
+ * ==========================================================================
14
+ */
15
+ /** Structured error from the cloud API */
16
+ export interface CloudError {
17
+ error: string;
18
+ status?: number;
19
+ hint?: string;
20
+ }
21
+ /** Result of a cloud API call — either success JSON or structured error */
22
+ export type CloudResult<T = unknown> = {
23
+ ok: true;
24
+ data: T;
25
+ } | {
26
+ ok: false;
27
+ error: CloudError;
28
+ };
29
+ /**
30
+ * Make an authenticated request to the Sterfive SaaS API.
31
+ *
32
+ * @param path - API path (e.g. "/v1/validate")
33
+ * @param body - Request body (string)
34
+ * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml")
35
+ * @returns Parsed JSON response or structured error
36
+ */
37
+ export declare function cloudFetch<T = unknown>(path: string, body: string, contentType: string): Promise<CloudResult<T>>;
38
+ /**
39
+ * Format a CloudError into a user-friendly MCP tool error response.
40
+ */
41
+ export declare function formatCloudError(err: CloudError): string;
package/dist/cloud.js ADDED
@@ -0,0 +1,147 @@
1
+ /**
2
+ * ==========================================================================
3
+ * OPC UA Modeler — Cloud API Client
4
+ *
5
+ * Thin HTTP wrapper for proxying MCP tool calls to the Sterfive SaaS API.
6
+ * ZERO proprietary dependencies — only native fetch.
7
+ *
8
+ * Configuration via environment variables:
9
+ * OPCUA_MODELER_API_URL — Base URL (default: https://api.opcua-modeler.sterfive.io)
10
+ * OPCUA_MODELER_API_KEY — API key (stfv_...) for authenticated endpoints
11
+ *
12
+ * IMPORTANT: Never use console.log() — stdout is reserved for JSON-RPC.
13
+ * ==========================================================================
14
+ */
15
+ const DEFAULT_API_URL = "https://api.opcua-modeler.sterfive.io";
16
+ const TIMEOUT_MS = 30_000;
17
+ function getApiUrl() {
18
+ return process.env.OPCUA_MODELER_API_URL || DEFAULT_API_URL;
19
+ }
20
+ function getApiKey() {
21
+ return process.env.OPCUA_MODELER_API_KEY;
22
+ }
23
+ /**
24
+ * Make an authenticated request to the Sterfive SaaS API.
25
+ *
26
+ * @param path - API path (e.g. "/v1/validate")
27
+ * @param body - Request body (string)
28
+ * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml")
29
+ * @returns Parsed JSON response or structured error
30
+ */
31
+ export async function cloudFetch(path, body, contentType) {
32
+ const baseUrl = getApiUrl();
33
+ const apiKey = getApiKey();
34
+ const url = `${baseUrl}${path}`;
35
+ const headers = {
36
+ "Content-Type": contentType,
37
+ Accept: "application/json"
38
+ };
39
+ if (apiKey) {
40
+ headers["Authorization"] = `Bearer ${apiKey}`;
41
+ }
42
+ try {
43
+ const controller = new AbortController();
44
+ const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
45
+ const response = await fetch(url, {
46
+ method: "POST",
47
+ headers,
48
+ body,
49
+ signal: controller.signal
50
+ });
51
+ clearTimeout(timeout);
52
+ if (response.ok) {
53
+ const data = (await response.json());
54
+ return { ok: true, data };
55
+ }
56
+ // Handle specific HTTP error codes with actionable messages
57
+ switch (response.status) {
58
+ case 401:
59
+ case 403:
60
+ return {
61
+ ok: false,
62
+ error: {
63
+ error: "Authentication required. Set OPCUA_MODELER_API_KEY in your MCP server config.",
64
+ status: response.status,
65
+ hint: "Get a free API key at https://opcua-modeler.sterfive.com/settings/api-keys"
66
+ }
67
+ };
68
+ case 429: {
69
+ const retryAfter = response.headers.get("Retry-After");
70
+ const upgradeUrl = response.headers.get("X-Upgrade-URL");
71
+ return {
72
+ ok: false,
73
+ error: {
74
+ error: `Rate limit exceeded.${retryAfter ? ` Try again in ${retryAfter}s.` : ""}`,
75
+ status: 429,
76
+ hint: upgradeUrl
77
+ ? `Upgrade your plan at ${upgradeUrl}`
78
+ : "Reduce request frequency or upgrade your plan."
79
+ }
80
+ };
81
+ }
82
+ case 422: {
83
+ // Validation error from the API (e.g. malformed YAML)
84
+ let detail = "";
85
+ try {
86
+ const errBody = await response.json();
87
+ detail = errBody.detail || errBody.message || "";
88
+ }
89
+ catch {
90
+ detail = await response.text();
91
+ }
92
+ return {
93
+ ok: false,
94
+ error: {
95
+ error: `Validation error: ${detail}`,
96
+ status: 422
97
+ }
98
+ };
99
+ }
100
+ default: {
101
+ let text = "";
102
+ try {
103
+ text = await response.text();
104
+ }
105
+ catch { /* ignore */ }
106
+ return {
107
+ ok: false,
108
+ error: {
109
+ error: `API error (HTTP ${response.status}): ${text || response.statusText}`,
110
+ status: response.status
111
+ }
112
+ };
113
+ }
114
+ }
115
+ }
116
+ catch (e) {
117
+ if (e instanceof DOMException && e.name === "AbortError") {
118
+ return {
119
+ ok: false,
120
+ error: {
121
+ error: `Request timed out after ${TIMEOUT_MS / 1000}s. The server may be unavailable.`,
122
+ hint: "Check https://opcua-modeler.sterfive.com/status for service status."
123
+ }
124
+ };
125
+ }
126
+ // Network errors (DNS, connection refused, etc.)
127
+ const message = e instanceof Error ? e.message : String(e);
128
+ return {
129
+ ok: false,
130
+ error: {
131
+ error: `Cannot reach the OPC UA Modeler API: ${message}`,
132
+ hint: "Check your network connection or verify the API URL."
133
+ }
134
+ };
135
+ }
136
+ }
137
+ /**
138
+ * Format a CloudError into a user-friendly MCP tool error response.
139
+ */
140
+ export function formatCloudError(err) {
141
+ const parts = [err.error];
142
+ if (err.hint) {
143
+ parts.push(`Hint: ${err.hint}`);
144
+ }
145
+ return parts.join("\n");
146
+ }
147
+ //# sourceMappingURL=cloud.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud.js","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"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"}
package/dist/server.d.ts CHANGED
@@ -2,13 +2,12 @@
2
2
  * ==========================================================================
3
3
  * OPC UA Modeler — MCP Server Factory (IP-Safe Version)
4
4
  *
5
- * Creates and configures the MCP server with 6 OPC UA companion-spec
6
- * discovery tools. All data comes from a static catalog.json file —
7
- * ZERO dependencies on proprietary @sterfive/* packages.
5
+ * Creates and configures the MCP server with 9 OPC UA tools:
6
+ * - 6 LOCAL tools: query the static type catalog (free, offline)
7
+ * - 3 CLOUD tools: proxy to api.opcua-modeler.sterfive.io
8
8
  *
9
9
  * Architecture: "Thin Local Shell" per Project Prometheus §1.1
10
- * - Local tools: query the static type catalog (free, offline)
11
- * - Cloud tools: proxy to api.opcua-modeler.sterfive.io (Phase 1b)
10
+ * ZERO dependencies on proprietary @sterfive/* packages.
12
11
  *
13
12
  * IMPORTANT: Never use console.log() — stdout may be reserved for JSON-RPC.
14
13
  * ==========================================================================
@@ -17,7 +16,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
17
16
  import { findEngineeringUnit, getTypeDetails, listNamespaces, listTypes, resolveDependencies, searchTypes } from "./catalog.js";
18
17
  export { findEngineeringUnit, getTypeDetails, listNamespaces, listTypes, resolveDependencies, searchTypes };
19
18
  /** Tool name type */
20
- export type ToolName = "resolve_dependencies" | "list_namespaces" | "list_types" | "get_type_details" | "search_types" | "find_engineering_unit";
19
+ export type ToolName = "resolve_dependencies" | "list_namespaces" | "list_types" | "get_type_details" | "search_types" | "find_engineering_unit" | "opcua_model_validate" | "opcua_model_generate" | "opcua_model_reverse";
21
20
  /**
22
21
  * Direct tool call handler for testing (bypasses MCP protocol).
23
22
  * Returns the same shape as MCP tool responses.
package/dist/server.js CHANGED
@@ -2,19 +2,19 @@
2
2
  * ==========================================================================
3
3
  * OPC UA Modeler — MCP Server Factory (IP-Safe Version)
4
4
  *
5
- * Creates and configures the MCP server with 6 OPC UA companion-spec
6
- * discovery tools. All data comes from a static catalog.json file —
7
- * ZERO dependencies on proprietary @sterfive/* packages.
5
+ * Creates and configures the MCP server with 9 OPC UA tools:
6
+ * - 6 LOCAL tools: query the static type catalog (free, offline)
7
+ * - 3 CLOUD tools: proxy to api.opcua-modeler.sterfive.io
8
8
  *
9
9
  * Architecture: "Thin Local Shell" per Project Prometheus §1.1
10
- * - Local tools: query the static type catalog (free, offline)
11
- * - Cloud tools: proxy to api.opcua-modeler.sterfive.io (Phase 1b)
10
+ * ZERO dependencies on proprietary @sterfive/* packages.
12
11
  *
13
12
  * IMPORTANT: Never use console.log() — stdout may be reserved for JSON-RPC.
14
13
  * ==========================================================================
15
14
  */
16
15
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
17
16
  import { z } from "zod";
17
+ import { cloudFetch, formatCloudError } from "./cloud.js";
18
18
  import { findEngineeringUnit, getTypeDetails, listNamespaces, listTypes, resolveDependencies, searchTypes } from "./catalog.js";
19
19
  // Re-export for testing
20
20
  export { findEngineeringUnit, getTypeDetails, listNamespaces, listTypes, resolveDependencies, searchTypes };
@@ -74,7 +74,7 @@ export async function handleToolCall(name, args) {
74
74
  export function createServer() {
75
75
  const server = new McpServer({
76
76
  name: "opcua-modeler",
77
- version: "1.0.0"
77
+ version: "1.1.0"
78
78
  });
79
79
  // ── 1. resolve_dependencies ──────────────────────────────────────────
80
80
  server.tool("resolve_dependencies", "Given one or more companion spec namespace aliases, returns the full " +
@@ -156,6 +156,71 @@ export function createServer() {
156
156
  content: [{ type: "text", text: JSON.stringify(result) }]
157
157
  };
158
158
  });
159
+ // ═══════════════════════════════════════════════════════════════════════
160
+ // CLOUD TOOLS — proxy to api.opcua-modeler.sterfive.io (Phase 1b)
161
+ // These require the SaaS API to be running. Set OPCUA_MODELER_API_KEY
162
+ // in env for authenticated access (generate/reverse require a key).
163
+ // ═══════════════════════════════════════════════════════════════════════
164
+ // ── 7. opcua_model_validate ───────────────────────────────────────────
165
+ server.tool("opcua_model_validate", "Validate an OPC UA YAML model for correctness. Returns diagnostics " +
166
+ "with severity (error/warning/info), codes, messages, and line numbers. " +
167
+ "Works without an API key (limited to 5 calls/day). " +
168
+ "ALWAYS validate before generating.", {
169
+ yaml: z.string().describe("The full YAML model source to validate")
170
+ }, async ({ yaml }) => {
171
+ const result = await cloudFetch("/api/v1/validate", yaml, "text/yaml");
172
+ if (!result.ok) {
173
+ return {
174
+ content: [{ type: "text", text: formatCloudError(result.error) }],
175
+ isError: true
176
+ };
177
+ }
178
+ return {
179
+ content: [{ type: "text", text: JSON.stringify(result.data) }]
180
+ };
181
+ });
182
+ // ── 8. opcua_model_generate ───────────────────────────────────────────
183
+ server.tool("opcua_model_generate", "Generate OPC UA NodeSet2.xml and Symbols.CSV from a YAML model. " +
184
+ "Requires an API key (set OPCUA_MODELER_API_KEY env var). " +
185
+ "Returns base64-encoded artifacts if the model is valid, " +
186
+ "or diagnostics if validation fails. " +
187
+ "Optionally set include_docs=true to also generate markdown documentation.", {
188
+ yaml: z.string().describe("The full YAML model source to generate from"),
189
+ include_docs: z.boolean().optional().describe("Set to true to include markdown documentation (slower)")
190
+ }, async ({ yaml, include_docs }) => {
191
+ const path = include_docs ? "/api/v1/generate?include=docs" : "/api/v1/generate";
192
+ const result = await cloudFetch(path, yaml, "text/yaml");
193
+ if (!result.ok) {
194
+ return {
195
+ content: [{ type: "text", text: formatCloudError(result.error) }],
196
+ isError: true
197
+ };
198
+ }
199
+ return {
200
+ content: [{ type: "text", text: JSON.stringify(result.data) }]
201
+ };
202
+ });
203
+ // ── 9. opcua_model_reverse ────────────────────────────────────────────
204
+ server.tool("opcua_model_reverse", "Reverse-engineer a NodeSet2.xml file back into the YAML DSL format. " +
205
+ "Requires an API key (set OPCUA_MODELER_API_KEY env var). " +
206
+ "Optionally specify the target namespace URI to extract.", {
207
+ xml: z.string().describe("The NodeSet2.xml content to reverse-engineer"),
208
+ namespace_uri: z.string().optional().describe("Target namespace URI to extract (auto-detected if omitted)")
209
+ }, async ({ xml, namespace_uri }) => {
210
+ const path = namespace_uri
211
+ ? `/api/v1/reverse?ns=${encodeURIComponent(namespace_uri)}`
212
+ : "/api/v1/reverse";
213
+ const result = await cloudFetch(path, xml, "application/xml");
214
+ if (!result.ok) {
215
+ return {
216
+ content: [{ type: "text", text: formatCloudError(result.error) }],
217
+ isError: true
218
+ };
219
+ }
220
+ return {
221
+ content: [{ type: "text", text: JSON.stringify(result.data) }]
222
+ };
223
+ });
159
224
  return server;
160
225
  }
161
226
  //# sourceMappingURL=server.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC;AAW5G;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,IAA6B;IAChF,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAmB,CAAC;gBACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACtG,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzC,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,YAAY,EAAE,CAAC,CAAC,IAAI;iBACrB,CAAC,CAAC,CAAC;gBACJ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/E,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACzG,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,KAAe,EAAE,IAAI,CAAC,UAAoB,CAAC,CAAC;gBAChF,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACpH,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACjF,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3G,CAAC;YACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;gBAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACnH,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAChF,CAAC;YACD;gBACE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7H,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7G,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,wEAAwE;IAExE,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,uEAAuE;QACrE,2EAA2E;QAC3E,0DAA0D,EAC5D,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC,EAAE,EACjH,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;aACrE,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,wEAAwE;IAExE,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,yEAAyE;QACvE,yFAAyF,EAC3F,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,YAAY,EAAE,CAAC,CAAC,IAAI;SACrB,CAAC,CAAC,CAAC;QACJ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,wEAAwE;IAExE,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,uEAAuE;QACrE,qCAAqC;QACrC,mFAAmF,EACrF,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC,EAAE,EAC3F,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,wEAAwE;IAExE,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,8EAA8E;QAC5E,6EAA6E;QAC7E,kDAAkD,EACpD;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;QAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;KACjG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,UAAU,mBAAmB,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;gBACrH,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,wEAAwE;IAExE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,0DAA0D;QACxD,+DAA+D;QAC/D,oDAAoD,EACtD,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC,EAAE,EACjG,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,yEAAyE;IAEzE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,mFAAmF;QACjF,gFAAgF,EAClF,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC,EAAE,EACnI,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;gBACrG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "node-opcua-modeler-mcp-server",
3
- "version": "1.0.0",
3
+ "version": "1.1.0",
4
+ "mcpName": "io.github.node-opcua/node-opcua-modeler-mcp-server",
4
5
  "description": "OPC UA Modeler MCP Server — exposes companion spec tools to AI agents",
5
6
  "type": "module",
6
7
  "main": "./dist/index.js",
@@ -11,6 +12,7 @@
11
12
  "files": [
12
13
  "dist/",
13
14
  "catalog/",
15
+ "server.json",
14
16
  "README.md",
15
17
  "SKILL.md"
16
18
  ],
package/server.json ADDED
@@ -0,0 +1,24 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
3
+ "name": "io.github.node-opcua/node-opcua-modeler-mcp-server",
4
+ "title": "OPC UA Modeler",
5
+ "description": "OPC UA companion spec types, namespace dependencies, and engineering units for AI agents",
6
+ "version": "1.1.0",
7
+ "websiteUrl": "https://opcua-modeler.sterfive.com",
8
+ "repository": {
9
+ "url": "https://github.com/node-opcua/node-opcua-modeler-mcp-server",
10
+ "source": "github"
11
+ },
12
+ "packages": [
13
+ {
14
+ "registryType": "npm",
15
+ "identifier": "node-opcua-modeler-mcp-server",
16
+ "version": "1.1.0",
17
+ "registryBaseUrl": "https://registry.npmjs.org",
18
+ "runtimeHint": "npx",
19
+ "transport": {
20
+ "type": "stdio"
21
+ }
22
+ }
23
+ ]
24
+ }