@codesys/mcp-toolkit 2.6.0 → 2.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codesys/mcp-toolkit",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "MCP server for CODESYS V3.5: read, write, compile and simulate Structured Text through a persistent CODESYS session",
   "mcpName": "io.github.johannesPettersson80/codesys-mcp-toolkit",
   "type": "module",

package/watcher/mcp_alarms.py

@@ -151,6 +151,47 @@ def op_alarms_list(args):
     return {"groups": groups}
 
 
+def op_textlists_translate(args):
+    """Translations into CODESYS's text lists (documented text-list scripting): the
+    GlobalTextList, where a visualization looks up its static texts by the text itself,
+    and the HMI's alarm group list (alarm messages, matched by their default text)."""
+    c = Ctx()
+    out = {"languages": [], "rows": 0, "added": 0, "errors": []}
+    lists = []
+    names = (["GlobalTextList"] if args.get("global", True) else []) + ([args["alarm_group"]] if args.get("alarm_group") else [])
+    for name in names:
+        for tl in c.proj.find(name, True):
+            if hasattr(tl, "rows"):
+                lists.append((name, tl))
+                break
+    for lang, texts in (args.get("translations") or {}).items():
+        out["languages"].append(lang)
+        for name, tl in lists:
+            try:
+                tl.addlanguage(lang)
+            except Exception:
+                pass  # it has the language already
+            rows = {}
+            for r in tl.rows:
+                rows[to_text(r.defaulttext)] = r
+            for text, tr in texts.items():
+                try:
+                    r = rows.get(text)
+                    if r is None:
+                        if name != "GlobalTextList":
+                            continue
+                        r = tl.rows.add(text, text)
+                        rows[text] = r
+                        out["added"] += 1
+                    r.setlanguagetext(lang, tr)
+                    out["rows"] += 1
+                except Exception as e:
+                    if len(out["errors"]) < 8:
+                        out["errors"].append("%s/%s: %s" % (name, text[:30], to_text(e)[:120]))
+    out["saved"] = c.save_if(args)
+    return out
+
+
 def op_visu_users(args):
     """Visualization user groups (no users: their passwords are the engineer's to set)."""
     import System
@@ -190,3 +231,4 @@ def op_visu_users(args):
 mcp_ops.OPS["alarms.configure"] = mcp_sim._locked(op_alarms_configure)
 mcp_ops.OPS["visu.users"] = mcp_sim._locked(op_visu_users)
 mcp_ops.OPS["alarms.list"] = op_alarms_list
+mcp_ops.OPS["textlists.translate"] = mcp_sim._locked(op_textlists_translate)

package/watcher/mcp_caps.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+# Which optional features this CODESYS offers. Several actions rely on CODESYS's
+# services beyond its documented scripting API, or on add-ons (visualization, alarm
+# management). Each check reaches the service the same way its module does, so a
+# feature reported available is one that action can use.
+#
+# Keep this file ASCII-only (IronPython 2.7 inside CODESYS).
+import os
+
+import mcp_ops
+from mcp_ops import _safe
+
+import scriptengine as se
+
+
+def _type(name):
+    from System import AppDomain
+    for a in AppDomain.CurrentDomain.GetAssemblies():
+        try:
+            t = a.GetType(name)
+        except Exception:
+            t = None
+        if t is not None:
+            return t
+    return None
+
+
+def _assembly(name):
+    from System import AppDomain
+    for a in AppDomain.CurrentDomain.GetAssemblies():
+        if a.GetName().Name == name:
+            return True
+    return False
+
+
+def _check(fn):
+    try:
+        return bool(fn())
+    except Exception:
+        return False
+
+
+def op_capabilities(args):
+    import mcp_lang
+    import mcp_debug
+    caps = {
+        "visualization": _check(lambda: hasattr(se, "VisualElementType")),
+        "signatures": _check(lambda: mcp_lang._service("LanguageModelMgr") is not None),
+        "cross_references": _check(lambda: mcp_lang._service("CrossReferenceService") is not None),
+        "debugging": _check(lambda: mcp_debug._bpm() is not None),
+        "trace": _check(lambda: hasattr(se, "trace")),
+        "alarms": _check(lambda: _assembly("AlarmConfigurationObjects.plugin")),
+        "visu_users": _check(lambda: _type("_3S.CoDeSys.VisualObject.VisuUserMgmtLibraryInserter") is not None),
+        "device_repository": _check(lambda: _safe(lambda: se.device_repository) is not None),
+        "library_manager": _check(lambda: getattr(se, "librarymanager", None) is not None),
+        "editor_window": os.environ.get("CODESYS_MCP_UI") == "1",
+    }
+    fpu = None
+    glm = getattr(se, "librarymanager", None)
+    if glm is not None:
+        fpu = _check(lambda: any((l.title or "").lower() == "floatingpointutils" for l in glm.get_all_libraries()))
+    caps["floating_point_utils"] = fpu
+    return {"capabilities": caps}
+
+
+mcp_ops.OPS["capabilities"] = op_capabilities

package/watcher/mcp_debug.py

@@ -83,6 +83,55 @@ def op_debug_set(args):
     return {"id": key}
 
 
+def op_debug_set_data(args):
+    """A data breakpoint: halt when a variable is written (optionally only when a condition holds)."""
+    import System
+    c = Ctx()
+    mcp_sim._online()
+    bpm = _bpm()
+    expr = args["expression"]
+    tasks = System.Array[str](args.get("tasks") or [])
+    try:
+        bp = bpm.CreateDataBreakpoint(c.app.guid, c.proj.handle, expr, int(args.get("size") or 0), tasks, _hit_always(), 0, False, args.get("condition") or "", "", "")
+    except AttributeError:
+        raise OpError("unavailable", "This CODESYS has no data breakpoints for scripts.")
+    bpm.SetBreakpoint(bp)
+    bpm.EnableBreakpoint(bp)
+    key = "data:%s" % expr
+    BPS[key] = bp
+    # With size 0 CODESYS keeps the breakpoint disabled; the server passes the variable's size.
+    return {"id": key, "enabled": bool(bp.IsEnabled)}
+
+
+def _call_stack(c):
+    """The call stack while halted: each entry's POU and instance, innermost first."""
+    out = []
+    try:
+        from System.Reflection import BindingFlags
+        om = None
+        for tname in ("_3S.CoDeSys.MemoryTools.APEnvironment", "_3S.CoDeSys.VisualEditor.APEnvironment", "_3S.CoDeSys.RecipeManObject.APEnvironment"):
+            t = _find_type(tname)
+            p = t.GetProperty("OnlineMgr", BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static) if t is not None else None
+            if p is not None:
+                om = p.GetValue(None, None)
+                if om is not None:
+                    break
+        if om is None:
+            return []
+        app = om.GetApplication(c.app.guid)
+        for e in list(app.CallStack or []):
+            # LocationInformation.EditorInstancePath: 'PLCWinNT.Application.PLC_PRG.fbCount';
+            # the task's own frames ('CallTask__MainTask', '__cycle__code__MainTask') are left out.
+            info = e.LocationInformation
+            path = to_text(info.EditorInstancePath or "")
+            if not path or path.split(".")[-1].startswith("__") or path.split(".")[-1].startswith("CallTask__"):
+                continue
+            out.append({"instance": path})
+    except Exception as ex:
+        out.append({"error": to_text(ex)[:160]})
+    return out
+
+
 def op_debug_clear(args):
     mcp_sim._online()
     bpm = _bpm()
@@ -120,6 +169,7 @@ def op_debug_status(args):
                     out["at"]["implementation"] = pos["implementation"]
         except Exception as e:
             out["at_error"] = to_text(e)
+        out["call_stack"] = _call_stack(c)
     return out
 
 
@@ -135,14 +185,16 @@ def op_debug_step(args):
 
 def op_debug_continue(args):
     online = mcp_sim._online()
-    online.start()
-    mcp_sim._pause(200)
+    if to_text(online.application_state).lower() != "run":
+        online.start()
+        mcp_sim._pause(200)
     return {"state": to_text(online.application_state)}
 
 
 mcp_ops.OPS.update({
     "debug.positions": op_debug_positions,
     "debug.set": op_debug_set,
+    "debug.set_data": op_debug_set_data,
     "debug.clear": op_debug_clear,
     "debug.status": op_debug_status,
     "debug.step": op_debug_step,

package/watcher/mcp_lang.py

@@ -101,7 +101,19 @@ def _signature(lmm, c, sig):
     ins = set(to_text(_get(v, "OrgName")) for v in (_get(sig, "Inputs") or []))
     outs = set(to_text(_get(v, "OrgName")) for v in (_get(sig, "Outputs") or []))
     variables = []
-    for v in lmm.GetAllVariables(sig, c.app.guid):
+    found = list(lmm.GetAllVariables(sig, c.app.guid) or [])
+    if not found:
+        # A method of a library FB: the language model keeps its variables on the signature.
+        for prop in ("All", "Variables", "AllVariables"):
+            vs = _get(sig, prop)
+            if vs:
+                try:
+                    found = list(vs)
+                except Exception:
+                    found = []
+                if found:
+                    break
+    for v in found:
         n = to_text(_get(v, "OrgName"))
         variables.append(_var(v, "input" if n in ins else "output" if n in outs else "other"))
     subs = []

package/watcher/watcher.py

@@ -260,6 +260,7 @@ def main(ui=False):
     import mcp_debug  # noqa: F401 (adds breakpoints and stepping)
     import mcp_devices  # noqa: F401 (adds device search and add)
     import mcp_alarms  # noqa: F401 (adds alarm management and visu user groups)
+    import mcp_caps  # noqa: F401 (adds the capability check)
     prompts = setup_prompts(se)
     log(prompts)
     if not hasattr(se, "FAKE"):
@@ -311,6 +312,7 @@ def main_attach():
     import mcp_debug  # noqa: F401 (adds breakpoints and stepping)
     import mcp_devices  # noqa: F401 (adds device search and add)
     import mcp_alarms  # noqa: F401 (adds alarm management and visu user groups)
+    import mcp_caps  # noqa: F401 (adds the capability check)
     prompts = setup_prompts(se)
     log(prompts)
     old = getattr(__builtin__, "_mcp_attach_timer", None)