# 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](https://nodejs.org/) (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:

```js
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:

```bash
cd your-project-directory
```

2. Install dependencies:

```bash
npm install
```

3. Edit config.js as shown above.

4. Start the server

```bash
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:

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

4. Ensure @modelcontextprotocol/tools is installed:

```bash
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.