dgwoOstjfn/tia_portal_mcp_server

cd tia_portal_mcp_server
python -m venv venv
venv\Scripts\activate
pip install -r MCP_Server/requirements.txt

venv\Scripts\python.exe MCP_Server\start_server.py test

{
  "mcpServers": {
    "tia-portal": {
      "command": "C:\\path\\to\\tia_portal_mcp_server\\launch_mcp.bat",
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

{
  "mcpServers": {
    "tia-portal": {
      "command": "C:\\path\\to\\tia_portal_mcp_server\\venv\\Scripts\\python.exe",
      "args": ["MCP_Server\\start_server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "TIA_SESSION_TIMEOUT": "3600",
        "TIA_MAX_SESSIONS": "3"
      }
    }
  }
}

result = await call_tool("create_block_from_scl", {
    "session_id": "your-session-id",
    "scl_content": """FUNCTION_BLOCK "FB_Motor"
VAR_INPUT
    Enable : Bool;
    Speed : Real;
END_VAR
VAR_OUTPUT
    Running : Bool;
END_VAR
BEGIN
    IF #Enable THEN
        #Running := TRUE;
    END_IF;
END_FUNCTION_BLOCK
""",
    "block_name": "FB_Motor",
    "target_folder": "Motors"
})

# Get what a block uses (outgoing references)
result = await call_tool("get_cross_references", {
    "session_id": "your-session-id",
    "block_name": "FB_MainSequence",
    "filter": "AllObjects"  # or ObjectsWithReferences, UnusedObjects
})
# Returns: FB_Blink, FB_Warning, DB_Global, etc.

# Get what uses a block (incoming references)
result = await call_tool("get_block_dependents", {
    "session_id": "your-session-id",
    "block_name": "FB_MainSequence"
})
# Returns: Main (OB1), DB_MainSequence (Instance DB)

# Find unused blocks for project cleanup
result = await call_tool("get_unused_blocks", {
    "session_id": "your-session-id",
    "verify_global_db": True  # Secondary verification for Global DBs
})
# Returns only truly unused blocks (filters out false positives for Global DBs)

# Convert XML to SCL
result = await call_tool("convert_format", {
    "input_path": "path/to/block.xml",
    "from_format": "xml",
    "to_format": "scl",
    "output_path": "path/to/output.scl"  # optional
})

# Supported conversions: xml↔json, json↔scl, xml↔scl

# Compile entire project
result = await call_tool("compile", {
    "session_id": "your-session-id",
    "target": "project"
})

# Compile specific device
result = await call_tool("compile", {
    "session_id": "your-session-id",
    "target": "device",
    "name": "PLC_1"
})

# Compile specific block
result = await call_tool("compile", {
    "session_id": "your-session-id",
    "target": "block",
    "name": "FB_Motor"
})

# Export all tag tables
result = await call_tool("export_tag_tables", {
    "session_id": "your-session-id",
    "output_path": "./exports"
})

# Export specific tables
result = await call_tool("export_tag_tables", {
    "session_id": "your-session-id",
    "table_names": ["Inputs", "Outputs"],
    "output_path": "./exports"
})

# Export all UDTs
result = await call_tool("export_udts", {
    "session_id": "your-session-id",
    "output_path": "./exports"
})

# Export specific UDTs
result = await call_tool("export_udts", {
    "session_id": "your-session-id",
    "udt_names": ["UDT_Motor", "UDT_Valve"],
    "output_path": "./exports"
})

{
  "paths": {
    "tia_portal": {
      "installation_path": "C:\\Program Files\\Siemens\\Automation\\Portal V20"
    }
  },
  "settings": {
    "session": {
      "timeout_seconds": 3600,
      "max_concurrent": 3
    }
  }
}