OPC UA Modeler MCP server
online · 100% uptimeio.github.node-opcua/node-opcua-modeler-mcp-server·v1.6.1·2 starsOPC UA companion spec types, namespace dependencies, and engineering units for AI agents
2 stars188 downloads/wk
Reviews
Write oneNobody has reviewed OPC UA Modeler yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
OPC UA Modeler tools (12, 1 write)
write = sends, deletes, buys or postsfind_engineering_unitFreeFind the official UNECE Rec. 20 engineering unit symbol for a given description. ALWAYS call this before using any engineering unit — NEVER guess unit symbols.
find_reusable_blockFreeFind reusable Interfaces / AddIns by capability — pass a member name or keyword (e.g. "SerialNumber", "DeviceHealth", "Location") and get the standard blocks that already expose it. PREFER applying/composing an existing block over redefining its members inline. Interfaces are applied with `interfaces:`; addins (types with a DefaultInstanceBrowseName) are composed with `addIns:`. A single property → use the Interface; a whole named sub-object → use the AddIn.
get_dsl_referenceFreeGet the grammar reference for the OPC UA modeler YAML DSL: file header, top-level sections, name-prefix conventions, minimal examples, and common mistakes. Call this FIRST before writing any YAML model by hand. Works without an API key.
get_type_detailsFreeGet detailed information about a specific type: its components, properties, methods, interfaces, and optional members. Use this to understand a type's structure before creating instances or subtypes. `specRef`, on the type and on a member, is the link to the section of the specification that defines it: cite it.
list_namespacesFreeList all well-known OPC UA companion spec namespace aliases with their full names, URIs, and dependencies. Use this to discover what namespaces are available.
list_typesFreeList ALL ObjectTypes, VariableTypes, and InterfaceTypes defined in a specific companion spec namespace. ALWAYS call this before using any type from a namespace — NEVER guess type names.
opcua_model_createwrite actionFreeGenerate an OPC UA YAML model from a natural language description using AI. Requires an API key (set OPCUA_MODELER_API_KEY env var). The AI will auto-detect relevant companion specs, generate a validated model with documentation, and auto-correct validation errors.
opcua_model_generateFreeGenerate OPC UA NodeSet2.xml and the symbols CSV from a YAML model. Requires an API key (set OPCUA_MODELER_API_KEY env var). NodeIds stay stable only if each regeneration passes back the symbols of the previous one: pass symbols_csv, or mode "new" for a first generation, or mode "renumber" to change ids on purpose. A call with none of these is refused with SYMBOLS_DECISION_REQUIRED. Returns base64-encoded artifacts if the model is valid. The result lists symbol counts (reused/new/dropped), hints and next steps.
opcua_model_reverseFreeReverse-engineer a NodeSet2.xml file back into the YAML DSL format. Requires an API key (set OPCUA_MODELER_API_KEY env var). Optionally specify the target namespace URI to extract.
opcua_model_validateFreeValidate an OPC UA YAML model for correctness. Returns diagnostics with severity (error/warning/info), codes, messages, and line numbers. Works without an API key (limited to 50 calls/day). ALWAYS validate before generating.
resolve_dependenciesFreeGiven one or more companion spec namespace aliases, returns the full resolved dependency list that MUST go in the YAML `namespaces:` section. Always call this before generating the namespaces block.
search_typesFreeSearch for types across ALL companion specs by keyword. Use this when you don't know which namespace defines a type. Returns matching types with their namespace alias.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan14 source files scanned25/25
- Live reliabilityremote reachable in 1960ms20/20
- Tool poisoning12 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 1 write-action tools with no auth3/15
- Maintenancelast push 8 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How OPC UA Modeler compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 87/100
- higher than 73% of 48,255 servers
- Tools
- 12
- the typical server has 7
- Tools that change things
- 8%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 90 ms
- faster than 86% of 30,031 servers
- GitHub stars
- 2
- more than 75% of 28,688 servers
- Downloads a week
- 188
- more than 74% of 12,191 servers with a package
What its tools let an agent do: 11 read · 1 change
Install OPC UA Modeler in Claude Code, Cursor or VS Code
claude mcp add --transport http node-opcua-modeler-mcp-server https://api.opcua-modeler.sterfive.io/api/mcp
What the publisher says
From the OPC UA Modeler repository's README, as published. We do not edit it. Read it on GitHub
node-opcua-modeler-mcp-server
An MCP server that gives AI agents access to the OPC UA companion specification type system — 749 types across 28 industrial namespaces, plus 1,533 engineering units — and lets agents validate, generate, reverse-engineer, and create OPC UA information models.
Built on node-opcua, the most widely used OPC UA stack for Node.js.
Why?
When an AI agent needs to build an OPC UA information model, it must know:
- What companion spec types exist (DI, Machinery, Robotics, Machine Tools…)
- What components, properties, and methods each type has
- What namespace dependencies are required
- What engineering unit symbols are valid (UNECE Rec. 20)
This MCP server answers all of those questions — offline, for free, in milliseconds.
Quick Start
With Claude Desktop
Add to your claudedesktopconfig.json:
{
"mcpServers": {
"opcua-modeler": {
"command": "npx",
"args": ["-y", "node-opcua-modeler-mcp-server"],
"env": {
"OPCUA_MODELER_API_KEY": "stfv_your_api_key_here"
}
}
}
}Note: The API key is optional for discovery tools (offline) and opcuamodelvalidate (50 anonymous calls/day). It is required for opcuamodelgenerate, opcuamodelreverse, and opcuamodelcreate. Register at opcua-modeler.sterfive.io and create a key under Settings → API — the free tier gives 25 calls/day for 90 days; see pricing for paid plans.
With any MCP client
npx node-opcua-modeler-mcp-serverThe server communicates over stdio using the Model Context Protocol.
Using a local backend instead of the hosted API
If you run the OPC UA Modeler CLI on the same machine, the model tools can be served from it instead of the hosted API — your YAML never leaves the host.
Start the server (requires a licence that includes the serve entitlement):
opcua-modeler serveThen set one environment variable in your MCP client config:
{
"mcpServers": {
"opcua-modeler": {
"command": "npx",
"args": ["-y", "node-opcua-modeler-mcp-server"],
"env": {
"OPCUA_MODELER_BACKEND": "local"
}
}
}
}No API key is needed in this mode — the client discovers the local endpoint and its credentials automatically.
Notes
local is selected and no server is running, the call fails with instructions rather than silently sending your model to the hosted API.
- The two backends are never mixed, and there is no fallback between them. If
setting.
- The seven discovery tools are local to this package and work offline on either
- opcuamodelcreate (AI generation) is available on the cloud backend only.
Tools
list_namespaces
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
OPC UA Modeler: common questions
- Is OPC UA Modeler MCP server safe?
- Yes, by our scan: it is graded A (87/100). Read the OPC UA Modeler safety report
- How do I install OPC UA Modeler?
- It runs remotely at api.opcua-modeler.sterfive.io. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does OPC UA Modeler need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is OPC UA Modeler maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v1.6.1.
- Is OPC UA Modeler up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does OPC UA Modeler compare with other MCP servers?
- safety score 87/100 (higher than 73% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 8% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.