Genius Automation — Community Edition

MCP server for Siemens TIA Portal — open-core, MIT-licensed Community Edition.

---

🎯 What is Genius Automation?

Genius Automation is a Model Context Protocol (MCP) server that lets AI agents (Claude Code, OpenClaw, Cursor, etc.) control Siemens TIA Portal V17+ — the leading industrial automation software used in factories worldwide.

This Community Edition ships with 5 essential read-only tools under the MIT License — free to use in commercial and non-commercial projects.

For the full Pro / Enterprise Edition (39 tools including write operations, multi-vendor, SLA), see: genius-automation-pro (private).

---

✨ Available Tools (Community Edition)

This Community Edition exposes 5 tools, all read-only and safe for production use:

Tool	Description
connect	Establish a session with TIA Portal. Required first call in any session.
read_tags	Read current values of one or more tags from a PLC.
list_blocks	List all blocks (OB/FB/FC/DB) in a given PLC.
get_project_tree	Get the hierarchical project tree: devices, block groups, tag tables.
compile	Compile the project (or a specific PLC) and return errors/warnings. Does NOT modify the PLC runtime — only validates the offline project.

For write operations (create/edit blocks, write tags, HMI screens, library management, advanced diagnostics, batch operations), upgrade to Pro (below).

---

🚀 Quick Start (3 steps)

Step 1 — Install

# Windows (with TIA Portal installed)
git clone https://github.com/your-org/genius-automation-community.git
cd genius-automation-community
python -m venv .venv
.venv\Scripts\activate
pip install -e .

# Linux/macOS (mock server only, no TIA Portal)
git clone https://github.com/your-org/genius-automation-community.git
cd genius-automation-community
python3.11 -m venv .venv
source .venv/bin/activate
pip install -e .

Step 2 — Run the Mock Server (Linux/macOS)

For testing without TIA Portal:

python -m mock.server --port 8001

Output:

╔══════════════════════════════════════════════════╗
║  Genius Automation Mock Server                   ║
║  Listening: http://0.0.0.0:8001                  ║
║  Mode: MOCK (no TIA Portal connection)            ║
║  Tools: 5/5 fixtures loaded                       ║
╚══════════════════════════════════════════════════╝

Step 3 — Connect from Your AI Agent

Configure your MCP-compatible agent (Claude Code, OpenClaw, Cursor) to point at the server:

{
  "mcpServers": {
    "genius-automation": {
      "command": "python",
      "args": ["-m", "mock.server"],
      "env": {"PORT": "8001"}
    }
  }
}

Then in the agent:

"List all blocks in PLC_1" → calls list_blocks "Read the motor speed tag" → calls read_tags "Compile the project and show errors" → calls compile

---

🏗 Architecture

┌─────────────────┐
│  AI Agent       │  (Claude Code, OpenClaw, Cursor, …)
│  (Linux/Mac)    │
└────────┬────────┘
         │ MCP protocol (HTTP/SSE)
         │
┌────────▼────────┐
│  W11 VM         │
│  (Windows)      │
│                 │
│  ┌───────────┐  │
│  │ MCP Server│  │  ← this repo
│  │ (Python)  │  │
│  └─────┬─────┘  │
│        │        │
│  ┌─────▼─────┐  │
│  │ pythonnet │  │
│  └─────┬─────┘  │
│        │        │
│  ┌─────▼─────┐  │
│  │ TIA Portal│  │  (Siemens software, V17+)
│  │  V17+     │  │
│  └───────────┘  │
└─────────────────┘

The MCP server runs on the same Windows machine as TIA Portal (because TIA Portal Openness