WinCC Unified MCP XT MCP Server

WinCC Unified MCP XT

A Model Context Protocol (MCP) server designed to interface with SIEMENS WinCC Unified SCADA systems via their GraphQL API. This server exposes various WinCC Unified functionalities as MCP tools, enabling AI assistants and other MCP-compatible clients to interact programmatically with the SCADA system.

This project is based on the repository by [Andreas Vogler](https://github.com/vogler75/winccua-mcp-server)

🔧 Features

• Connects to a WinCC Unified GraphQL endpoint.
• Provides MCP tools for:
  • ✅ User authentication (login-user)
  • 📂 Browsing SCADA objects (browse-objects)
  • 📊 Reading current tag values (get-tag-values)
  • 🕒 Querying historical/logged tag data (get-logged-tag-values)
  • 🚨 Fetching active alarms (get-active-alarms)
  • 📁 Fetching logged alarms (get-logged-alarms)
  • ✍️ Writing values to tags (write-tag-values)
  • 🟢 Acknowledging alarms (acknowledge-alarms)
  • 🔄 Resetting alarms (reset-alarms)
• Optional automatic service account login with token refresh mechanism.

⚙️ Prerequisites

• Node.js (v18.x or newer recommended)
• npm (comes with Node.js)
• Access to a running WinCC Unified GraphQL server endpoint

⚙️ Configuration

this server uses a config.js file written in ES module syntax.

`config.js` (ESM) example:

export const config = {
  URL: "https://your-wincc-server.example.com/graphql", // required
  userName: "service_account_username", // optional
  pwr: "service_account_password", // optional
};

🚀 How to Start

1. Navigate to the project folder:

cd your-project-directory

2. Install dependencies:

npm install

3. Edit config.js as shown above.

4. Start the server

node start

🖥️ Connecting with Claude Desktop

To use this MCP server with Claude AI (desktop version):

1. Find or create the claude_desktop_config.json file (typically in the Claude app config folder).

2. Add or update the following:

{
  "mcpServers": {
    "WinCC Unified": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

4. Ensure @modelcontextprotocol/tools is installed:

npm install -g @modelcontextprotocol/tools

🧰 Available MCP Tools

📝 Notes

• If configured, a service account is automatically logged in and token refreshed every minute.

• A user's manual login overrides the service session temporarily.