Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
Connect AI assistants to industrial OPC UA: browse, read, history, subscriptions, events and alarms.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
OPCUA_SERVER_URL, OPCUA_PYTHON_BACKEND, OPCUA_SECURITY_POLICY, OPCUA_SECURITY_MODE, OPCUA_CLIENT_CERT, OPCUA_CLIENT_KEY, OPCUA_APPLICATION_URI, OPCUA_SERVER_CERT, OPCUA_SERVER_TRUST_STORE, OPCUA_SERVER_APPLICATION_URI, OPCUA_USERNAME, OPCUA_PASSWORD, OPCUA_USER_CERT, OPCUA_USER_KEY, OPCUA_PROFILE, OPCUA_POLICY_FILE, OPCUA_ALLOWED_TOOLS, OPCUA_ALLOWED_WRITE_NODES, OPCUA_ALLOWED_METHODS, OPCUA_ALLOW_ACKNOWLEDGE_ALARMS, OPCUA_ALLOW_INSECURE_CONTROL, OPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL, OPCUA_ALLOW_OUT_OF_RANGE_WRITES, OPCUA_AUDIT_FILE, OPCUA_AUDIT_FSYNC, OPCUA_AUDIT_CHAIN, OPCUA_AUDIT_CHAIN_KEY_FILE, OPCUA_OPERATOR_ID, OPCUA_RECONNECT_INITIAL_DELAY_MS, OPCUA_RECONNECT_MAX_DELAY_MS, OPCUA_RECONNECT_MAX_RETRY, OPCUA_SESSION_TIMEOUT_MSValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"opcua": {
"command": "npx",
"args": [
"-y",
"opcua-mcp-server"
],
"env": {
"OPCUA_SERVER_URL": "your-value",
"OPCUA_PYTHON_BACKEND": "your-value",
"OPCUA_SECURITY_POLICY": "your-value",
"OPCUA_SECURITY_MODE": "your-value",
"OPCUA_CLIENT_CERT": "your-value",
"OPCUA_CLIENT_KEY": "your-value",
"OPCUA_APPLICATION_URI": "your-value",
"OPCUA_SERVER_CERT": "your-value",
"OPCUA_SERVER_TRUST_STORE": "your-value",
"OPCUA_SERVER_APPLICATION_URI": "your-value",
"OPCUA_USERNAME": "your-value",
"OPCUA_PASSWORD": "your-value",
"OPCUA_USER_CERT": "your-value",
"OPCUA_USER_KEY": "your-value",
"OPCUA_PROFILE": "your-value",
"OPCUA_POLICY_FILE": "your-value",
"OPCUA_ALLOWED_TOOLS": "your-value",
"OPCUA_ALLOWED_WRITE_NODES": "your-value",
"OPCUA_ALLOWED_METHODS": "your-value",
"OPCUA_ALLOW_ACKNOWLEDGE_ALARMS": "your-value",
"OPCUA_ALLOW_INSECURE_CONTROL": "your-value",
"OPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL": "your-value",
"OPCUA_ALLOW_OUT_OF_RANGE_WRITES": "your-value",
"OPCUA_AUDIT_FILE": "your-value",
"OPCUA_AUDIT_FSYNC": "your-value",
"OPCUA_AUDIT_CHAIN": "your-value",
"OPCUA_AUDIT_CHAIN_KEY_FILE": "your-value",
"OPCUA_OPERATOR_ID": "your-value",
"OPCUA_RECONNECT_INITIAL_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_RETRY": "your-value",
"OPCUA_SESSION_TIMEOUT_MS": "your-value"
}
}
}
}Run this in your terminal
claude mcp add opcua --env OPCUA_SERVER_URL=your-value --env OPCUA_PYTHON_BACKEND=your-value --env OPCUA_SECURITY_POLICY=your-value --env OPCUA_SECURITY_MODE=your-value --env OPCUA_CLIENT_CERT=your-value --env OPCUA_CLIENT_KEY=your-value --env OPCUA_APPLICATION_URI=your-value --env OPCUA_SERVER_CERT=your-value --env OPCUA_SERVER_TRUST_STORE=your-value --env OPCUA_SERVER_APPLICATION_URI=your-value --env OPCUA_USERNAME=your-value --env OPCUA_PASSWORD=your-value --env OPCUA_USER_CERT=your-value --env OPCUA_USER_KEY=your-value --env OPCUA_PROFILE=your-value --env OPCUA_POLICY_FILE=your-value --env OPCUA_ALLOWED_TOOLS=your-value --env OPCUA_ALLOWED_WRITE_NODES=your-value --env OPCUA_ALLOWED_METHODS=your-value --env OPCUA_ALLOW_ACKNOWLEDGE_ALARMS=your-value --env OPCUA_ALLOW_INSECURE_CONTROL=your-value --env OPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL=your-value --env OPCUA_ALLOW_OUT_OF_RANGE_WRITES=your-value --env OPCUA_AUDIT_FILE=your-value --env OPCUA_AUDIT_FSYNC=your-value --env OPCUA_AUDIT_CHAIN=your-value --env OPCUA_AUDIT_CHAIN_KEY_FILE=your-value --env OPCUA_OPERATOR_ID=your-value --env OPCUA_RECONNECT_INITIAL_DELAY_MS=your-value --env OPCUA_RECONNECT_MAX_DELAY_MS=your-value --env OPCUA_RECONNECT_MAX_RETRY=your-value --env OPCUA_SESSION_TIMEOUT_MS=your-value -- npx -y opcua-mcp-serverFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"opcua": {
"command": "npx",
"args": [
"-y",
"opcua-mcp-server"
],
"env": {
"OPCUA_SERVER_URL": "your-value",
"OPCUA_PYTHON_BACKEND": "your-value",
"OPCUA_SECURITY_POLICY": "your-value",
"OPCUA_SECURITY_MODE": "your-value",
"OPCUA_CLIENT_CERT": "your-value",
"OPCUA_CLIENT_KEY": "your-value",
"OPCUA_APPLICATION_URI": "your-value",
"OPCUA_SERVER_CERT": "your-value",
"OPCUA_SERVER_TRUST_STORE": "your-value",
"OPCUA_SERVER_APPLICATION_URI": "your-value",
"OPCUA_USERNAME": "your-value",
"OPCUA_PASSWORD": "your-value",
"OPCUA_USER_CERT": "your-value",
"OPCUA_USER_KEY": "your-value",
"OPCUA_PROFILE": "your-value",
"OPCUA_POLICY_FILE": "your-value",
"OPCUA_ALLOWED_TOOLS": "your-value",
"OPCUA_ALLOWED_WRITE_NODES": "your-value",
"OPCUA_ALLOWED_METHODS": "your-value",
"OPCUA_ALLOW_ACKNOWLEDGE_ALARMS": "your-value",
"OPCUA_ALLOW_INSECURE_CONTROL": "your-value",
"OPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL": "your-value",
"OPCUA_ALLOW_OUT_OF_RANGE_WRITES": "your-value",
"OPCUA_AUDIT_FILE": "your-value",
"OPCUA_AUDIT_FSYNC": "your-value",
"OPCUA_AUDIT_CHAIN": "your-value",
"OPCUA_AUDIT_CHAIN_KEY_FILE": "your-value",
"OPCUA_OPERATOR_ID": "your-value",
"OPCUA_RECONNECT_INITIAL_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_RETRY": "your-value",
"OPCUA_SESSION_TIMEOUT_MS": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"opcua": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"opcua-mcp-server"
],
"env": {
"OPCUA_SERVER_URL": "your-value",
"OPCUA_PYTHON_BACKEND": "your-value",
"OPCUA_SECURITY_POLICY": "your-value",
"OPCUA_SECURITY_MODE": "your-value",
"OPCUA_CLIENT_CERT": "your-value",
"OPCUA_CLIENT_KEY": "your-value",
"OPCUA_APPLICATION_URI": "your-value",
"OPCUA_SERVER_CERT": "your-value",
"OPCUA_SERVER_TRUST_STORE": "your-value",
"OPCUA_SERVER_APPLICATION_URI": "your-value",
"OPCUA_USERNAME": "your-value",
"OPCUA_PASSWORD": "your-value",
"OPCUA_USER_CERT": "your-value",
"OPCUA_USER_KEY": "your-value",
"OPCUA_PROFILE": "your-value",
"OPCUA_POLICY_FILE": "your-value",
"OPCUA_ALLOWED_TOOLS": "your-value",
"OPCUA_ALLOWED_WRITE_NODES": "your-value",
"OPCUA_ALLOWED_METHODS": "your-value",
"OPCUA_ALLOW_ACKNOWLEDGE_ALARMS": "your-value",
"OPCUA_ALLOW_INSECURE_CONTROL": "your-value",
"OPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL": "your-value",
"OPCUA_ALLOW_OUT_OF_RANGE_WRITES": "your-value",
"OPCUA_AUDIT_FILE": "your-value",
"OPCUA_AUDIT_FSYNC": "your-value",
"OPCUA_AUDIT_CHAIN": "your-value",
"OPCUA_AUDIT_CHAIN_KEY_FILE": "your-value",
"OPCUA_OPERATOR_ID": "your-value",
"OPCUA_RECONNECT_INITIAL_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_DELAY_MS": "your-value",
"OPCUA_RECONNECT_MAX_RETRY": "your-value",
"OPCUA_SESSION_TIMEOUT_MS": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
OPCUA_PYTHON_BACKEND envOPCUA_SECURITY_POLICY envOPCUA_SECURITY_MODE envOPCUA_CLIENT_CERT envOPCUA_APPLICATION_URI envOPCUA_SERVER_CERT envOPCUA_SERVER_TRUST_STORE envOPCUA_SERVER_APPLICATION_URI envOPCUA_USERNAME envOPCUA_USER_CERT envOPCUA_POLICY_FILE envOPCUA_ALLOWED_TOOLS envOPCUA_ALLOWED_WRITE_NODES envOPCUA_ALLOWED_METHODS envOPCUA_ALLOW_ACKNOWLEDGE_ALARMS envOPCUA_ALLOW_INSECURE_CONTROL envOPCUA_ALLOW_UNVERIFIED_SERVER_CONTROL envOPCUA_ALLOW_OUT_OF_RANGE_WRITES envOPCUA_AUDIT_FILE envOPCUA_AUDIT_FSYNC envOPCUA_AUDIT_CHAIN envOPCUA_OPERATOR_ID envOPCUA_RECONNECT_INITIAL_DELAY_MS envOPCUA_RECONNECT_MAX_DELAY_MS envOPCUA_RECONNECT_MAX_RETRY envOPCUA_SESSION_TIMEOUT_MS envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The publisher (midhunxavier) is not the repo owner (IndustriAgents); someone else may have listed it
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 0 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: OPCUA_SERVER_URL, OPCUA_CLIENT_KEY, OPCUA_PASSWORD, OPCUA_USER_KEY, OPCUA_PROFILE, OPCUA_AUDIT_CHAIN_KEY_FILE
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (0.6.0) reached the registry 2 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Spec Driven Development, Remote Desktop Commander, 好縮 Short
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Smart URL shortener: create, tag and track short links on s.gooo.name.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Let Claude, Codex, Gemini and any other MCP agent read sensors, browse the plant and — only when you allow it — control equipment on any OPC UA server.
[▶ Try it without hardware](#try-it-without-a-plant) — a simulated plant ships in this repository
Quick start · Connect your agent · Tools · Production · Docs · Contributing
Official MCP Registry · Glama · HardwareMCP
Every tool call and value above is a real response from the bundled simulator, recorded through the Python bridge under the read-only observe profile; the question and answer text are scripted. Rebuild it with scripts/readme_demo.py.
This project is a bridge between an AI agent and an OPC UA server. OPC UA is the protocol used to expose industrial equipment and its data; MCP (Model Context Protocol) lets an agent call tools to work with that data. The bridge runs on your computer and connects to an existing OPC UA server, or to a local simulator for a first test.
Your MCP client starts the bridge as a local stdio process: it exchanges MCP messages over standard input and output. One process connects one client context to one OPC UA endpoint. Use a separate process for each endpoint. Remote MCP and shared multi-client operation are gated by the identity and isolation RFC.
operator profile also requires allowlisted targets, and every control call is audited..mcpb bundle with nothing else to set up.flowchart LR
A["AI agent (Claude, Codex, Gemini, Cursor…)"] -->|MCP over stdio| B["OPC UA MCP Server (Python or Node)"] B -->|OPC UA| C["OPC UA server (PLC / SCADA / historian)"]
Follow these steps in order: choose an installation, start or identify an OPC UA server, configure your MCP client, then check the connection. You need an MCP client such as one of the agents listed below.
Choose one runtime; you do not need both. The package routes fetch the server on demand, so you do not need to clone this repository to use an existing OPC UA server.
| Route | Prerequisites | Command your MCP client launches |
|---|---|---|
| Node package | Node.js 22.13+, including npm and npx | npx -y opcua-mcp-server |
| Python package | Python 3.10+ and uv (which supplies uvx) | uvx opcua-mcp-server |
| Claude Desktop bundle | Claude Desktop; no separate Node or Python installation | Install the .mcpb file as described below |
| Single-file executable | Download for your platform; no Node or Python installation | Use its absolute path as the client command; see installation instructions |
For a package route, check that it can run from your terminal. Run the command for your chosen runtime:
# Node
npx -y opcua-mcp-server --version
uvx opcua-mcp-server --version
These commands print a version and exit. In normal use, your MCP client launches the server without --version; you do not also start the bridge in a separate terminal. A bridge started by itself waits for MCP messages, rather than showing an interactive prompt or a web page.
For an existing server, get its endpoint URL, including any path, from its administrator (for example opc.tcp://192.168.0.10:4840). The bridge reads it from OPCUA_SERVER_URL, which you set in your MCP client's configuration in step 3. If unset, the default is opc.tcp://localhost:4840.
The default profile is observe (read-only), and the default OPC UA connection is unencrypted and anonymous. Use those defaults for the local mock. For real equipment, prepare the security configuration before connecting.
If you do not have an OPC UA server, start the bundled simulated plant. This optional route needs Git, Python 3.10+ and uv, even if you chose the Node bridge. Run these commands in a terminal:
git clone https://github.com/IndustriAgents/OPCUA-MCP.git
cd OPCUA-MCP uv sync --all-packages uv run --no-sync opcua-mock-server
Wait for Server is running and ready for connections, then leave this terminal running. The mock listens on port 4840; use opc.tcp://localhost:4840/freeopcua/server/ as your endpoint. Stop it with Ctrl-C when finished. If the port is busy, choose another port with uv run --no-sync opcua-mock-server --endpoint opc.tcp://127.0.0.1:14840/freeopcua/server/ and use that URL in your client configuration.
The plant supports browsing, sensor reads, data-change subscriptions, raw value history, plain events and event history. It also has writable actuators and methods, subject to the bridge's control policy. It does not implement processed aggregates or Alarms & Conditions: its plain alarm events cannot be listed as retained conditions, acknowledged or acted on with alarm-action tools. Use the separate mocks for those operations:
| Mock | Endpoint | Coverage |
|---|---|---|
| Plant | opc.tcp://localhost:4840/freeopcua/server/ | Sensors, actuators, methods, raw history, subscriptions and plain events |
| Aggregates | opc.tcp://localhost:4841/UA/Aggregate | Processed history, such as average buckets |
| Alarms | opc.tcp://localhost:4842/UA/Alarms | Active conditions and acknowledgement |
The separate mocks need Node and npm; their READMEs give installation and startup commands. The MCP Inspector walkthrough has more examples, and the compatibility matrix records tested coverage.
Pick one client below. The examples use the local plant endpoint from step 2; replace opc.tcp://localhost:4840/freeopcua/server/ with your endpoint if needed. For a secure connection, add the settings from Going to production to the same env block (or the bundle's settings fields).
To use Python in a JSON configuration, set "command": "uvx" and "args": ["opcua-mcp-server"]. In a CLI registration command, replace npx -y opcua-mcp-server with uvx opcua-mcp-server. In TOML, use command = "uvx" and args = ["opcua-mcp-server"].
Claude Desktop
Easiest — the bundle. Download opcua-mcp-server- .mcpb from the latest release, drag it into Settings → Extensions, and fill in OPC UA endpoint. No Node, no Python, no JSON.
Or let the server write the config (needs Node or Python):
npm install -g opcua-mcp-server # or: uv tool install opcua-mcp-server
opcua-mcp-server --install claude-desktop --url opc.tcp://localhost:4840/freeopcua/server/ --dry-run
It checks the config with the server's own startup validation and writes absolute paths, because Claude Desktop does not inherit your shell's PATH. The profile defaults to read-only; encryption, a pinned server certificate, a control profile, a policy file and an audit file are all flags, and passwords are never taken as flags. Check the preview, then repeat the command without --dry-run to write the configuration and restart Claude Desktop. Every flag and safety rule, editing claude_desktop_config.json by hand, and fixing a server that fails to start: docs/install.md.
Claude Code
claude mcp add opcua -e OPCUA_SERVER_URL=opc.tcp://localhost:4840/freeopcua/server/ -- npx -y opcua-mcp-server
Add --scope project to share it with your team through .mcp.json.
OpenAI Codex
codex mcp add opcua --env OPCUA_SERVER_URL=opc.tcp://localhost:4840/freeopcua/server/ -- npx -y opcua-mcp-server
Or add it to ~/.codex/config.toml:
[mcp_servers.opcua]
command = "npx" args = ["-y", "opcua-mcp-server"] env = { OPCUA_SERVER_URL = "opc.tcp://localhost:4840/freeopcua/server/" }
Or let the server write that entry, with the same checks as for Claude Desktop: opcua-mcp-server --install codex --url opc.tcp://localhost:4840/freeopcua/server/ --dry-run. This installer command requires a permanent package installation first: npm install -g opcua-mcp-server or uv tool install opcua-mcp-server. Check the preview and repeat without --dry-run to write it.
Gemini CLI
Add to ~/.gemini/settings.json, or .gemini/settings.json in a project:
{
"mcpServers": { "opcua": { "command": "npx", "args": ["-y", "opcua-mcp-server"], "env": { "OPCUA_SERVER_URL": "opc.tcp://localhost:4840/freeopcua/server/" } } } }
Google Antigravity
In the agent panel, open ⋯ → MCP Servers → Manage MCP Servers → View raw config, add the entry below to mcp_config.json, and restart Antigravity:
{
"mcpServers": { "opcua": { "command": "npx", "args": ["-y", "opcua-mcp-server"], "env": { "OPCUA_SERVER_URL": "opc.tcp://localhost:4840/freeopcua/server/" } } } }
Cursor
Add to ~/.cursor/mcp.json, or .cursor/mcp.json in a project:
{
"mcpServers": { "opcua": { "command": "npx", "args": ["-y", "opcua-mcp-server"], "env": { "OPCUA_SERVER_URL": "opc.tcp://localhost:4840/freeopcua/server/" } } } }
VS Code (GitHub Copilot)
Add to .vscode/mcp.json — note the top-level key is servers:
`
Only the beginning is shown; read the rest in the repo