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

---

🔧 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

Tool	Description
login-user	Logs in with username/password.
browse-objects	Browses configured SCADA elements.
get-tag-values	Retrieves live tag values.
get-logged-tag-values	Gets historical tag data.
get-active-alarms	Lists currently active alarms.
get-logged-alarms	Shows previously triggered alarms.
write-tag-values	Updates one or more tags.
acknowledge-alarms	Acknowledges alarms.
reset-alarms	Resets alarms.

📝 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.