@agentikos/omega-os 0.19.15 → 0.19.16

package/omega/Agentik_Engine/omega_engine/__init__.py

@@ -188,7 +188,7 @@ from omega_engine.genesis import (
 )
 from omega_engine import plan as plan_v7
 
-__version__ = "0.19.15"
+__version__ = "0.19.16"
 
 __all__ = [
     "__version__",

package/omega/Agentik_Engine/omega_engine/sync.py

@@ -194,13 +194,32 @@ class ClaudeCodeAdapter:
             cat = catalog_by_id.get(sid, {})
             install = cat.get("install") or {}
 
-            # Prefer the locally installed binary; fall back to `npx <package>`.
-            if tool and tool.invoke:
+            # Resolve the launch command. Three shapes:
+            #   1. uvx:<package>            — Python MCP via Astral uvx (no
+            #      local binary; Claude calls `uvx <package>` at runtime)
+            #   2. tool.invoke = relative path → resolved binary on disk
+            #   3. catalog install method → `npx -y <package>` or
+            #      `uvx <package>` synthesized from the catalog alone
+            catalog_args = list(install.get("args") or [])
+            server_args = list(server.get("args") or [])
+            if tool and tool.invoke and tool.invoke.startswith("uvx:"):
+                # uvx-managed Python MCP server.
+                pkg = tool.invoke[len("uvx:"):]
+                entry["command"] = "uvx"
+                entry["args"] = [pkg, *catalog_args, *server_args]
+            elif tool and tool.invoke:
                 entry["command"] = str(omega_home / tool.invoke)
-                entry["args"] = list(server.get("args") or [])
+                entry["args"] = [*catalog_args, *server_args]
             elif install.get("method") == "npx" and install.get("package"):
                 entry["command"] = "npx"
-                entry["args"] = ["-y", str(install["package"]), *(server.get("args") or [])]
+                entry["args"] = ["-y", str(install["package"]),
+                                 *catalog_args, *server_args]
+            elif install.get("method") == "uvx" and install.get("package"):
+                # No local install (cold uvx call at runtime — slow first time
+                # but works without ever running `omega tool install`).
+                entry["command"] = "uvx"
+                entry["args"] = [str(install["package"]),
+                                 *catalog_args, *server_args]
             else:
                 # nothing to invoke — skip rather than write a half-broken entry
                 continue

package/omega/Agentik_Engine/omega_engine/tools.py

@@ -215,6 +215,45 @@ def install_from_catalog(
         except (OSError, json.JSONDecodeError):
             version = ""
 
+    elif method == "uvx" and package:
+        # Python MCP servers (mcp-server-git, mcp-server-fetch, etc.) run
+        # via `uvx <package>` — Astral fetches + caches the package on
+        # first call. We don't install it locally; we just verify `uv`
+        # is on PATH and pre-warm the cache so the first `claude` call
+        # doesn't pay the cold-fetch latency.
+        uv = shutil.which("uv") or str(Path.home() / ".local" / "bin" / "uv")
+        if not Path(uv).exists():
+            raise RuntimeError(
+                "uv not found on PATH — install with "
+                "`curl -LsSf https://astral.sh/uv/install.sh | sh` to use uvx MCP servers"
+            )
+        # Pre-warm: `uv tool install` makes the package globally available
+        # as a uv tool (resolves once, ~5s) so subsequent `uvx <package>`
+        # invocations are instant. Failure here is non-fatal — `uvx` will
+        # still resolve at call time, just slower.
+        try:
+            res = subprocess.run(
+                [uv, "tool", "install", "--quiet", package],
+                check=False, capture_output=True, text=True, timeout=300,
+            )
+            # Best-effort version detect via `uv tool list`.
+            ls = subprocess.run(
+                [uv, "tool", "list"], capture_output=True, text=True, timeout=15,
+            )
+            for line in (ls.stdout or "").splitlines():
+                line = line.strip()
+                if line.startswith(package + " "):
+                    # Format: "<package> v<version>"
+                    parts = line.split()
+                    if len(parts) >= 2:
+                        version = parts[1].lstrip("v")
+                        break
+        except subprocess.SubprocessError:
+            pass
+        # invoke is `uvx <package>` — sync.py renders it directly to the
+        # Claude .mcp.json (no local binary needed).
+        invoke = f"uvx:{package}"
+
     tool = Tool(
         name=mcp_id,
         version=version,

package/omega/Agentik_Engine/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "omega-engine"
-version = "0.19.15"
+version = "0.19.16"
 description = "The Omega OS orchestration engine — event-sourced, verified-completion agent graphs."
 readme = "README.md"
 requires-python = ">=3.11"

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.15
+0.19.16

package/omega/Agentik_SSOT/mcp/mcp-catalog.yaml

@@ -18,7 +18,10 @@ catalog:
     name: Git
     description: Read/inspect git repositories
     category: core
-    install: { method: npx, package: "@modelcontextprotocol/server-git" }
+    # Official MCP git server is Python — runs via uvx (Astral). The old
+    # npm package `@modelcontextprotocol/server-git` returns 404 — it was
+    # never published; only the Python `mcp-server-git` on PyPI exists.
+    install: { method: uvx, package: "mcp-server-git" }
     recommended: true
 
   - id: github
@@ -41,8 +44,10 @@ catalog:
     name: Higgsfield
     description: Image and video generation
     category: media
-    install: { method: npx, package: "@higgsfield/mcp" }
-    secrets: [HIGGSFIELD_API_KEY]
+    # Correct npm package name is `higgsfield-mcp` (no @ scope). The
+    # scoped `@higgsfield/mcp` returns 404 — was never published.
+    install: { method: npx, package: "higgsfield-mcp" }
+    secrets: [HF_API_KEY, HF_SECRET]
     recommended: false
 
   - id: playwright
@@ -63,7 +68,10 @@ catalog:
     name: Fetch
     description: Fetch and convert web content
     category: core
-    install: { method: npx, package: "@modelcontextprotocol/server-fetch" }
+    # Official MCP fetch server is Python — runs via uvx. The npm
+    # package `@modelcontextprotocol/server-fetch` returns 404 — was
+    # never published. PyPI ships `mcp-server-fetch`.
+    install: { method: uvx, package: "mcp-server-fetch" }
     recommended: true
 
   - id: memory
@@ -98,10 +106,12 @@ catalog:
 
   - id: linear
     name: Linear
-    description: Issues and project management
+    description: Issues and project management (Linear-hosted remote MCP)
     category: project
-    install: { method: npx, package: "@linear/mcp" }
-    secrets: [LINEAR_API_KEY]
+    # Linear ships an OFFICIAL remote MCP at https://mcp.linear.app/mcp,
+    # accessed via the `mcp-remote` npm proxy. No API key in env —
+    # OAuth happens in-browser the first time Claude connects.
+    install: { method: npx, package: "mcp-remote", args: ["https://mcp.linear.app/mcp"] }
     recommended: false
 
   - id: sentry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentikos/omega-os",
-  "version": "0.19.15",
+  "version": "0.19.16",
   "description": "Omega OS — installable agentic operating system with verified-completion orchestration. Event-sourced engine, 8-block rack, autonomous agents, MCP.",
   "bin": {
     "omega-os": "bin/omega-os.js"