Piron AI Architecture & MCP Reference

Quickstart: Local MCP Server Installation

Install the enterprise MCP runner using Python 3.11+:

pip install piron-ai-mcp
# Run local Windows UI automation supervisor
python -m piron_ai.windows --port 16180 --supervisor

Configure Claude Desktop or Claude Code with your local MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "nexus-computer": {
      "command": "python",
      "args": ["-m", "piron_ai.windows"]
    },
    "nexus-browser": {
      "command": "python",
      "args": ["-m", "piron_ai.browser"]
    }
  }
}

NexusWindows MCP Driver

Provides programmatic control over Windows 10/11 desktop environments without blind pixel guessing. Uses native Win32 accessibility trees and UI Automation (UIA) APIs.

• computer_look: Inspects open top-level windows, z-order, bounding boxes, and focused controls in a single deterministic pass.
• computer_act: Dispatches discrete user input events (click, text typing, shortcut combos) with automatic coordinate scaling.
• Fail-safe halt contract: Execution stops immediately if window focus shifts unexpectedly or if target control geometry changes.

NexusBrowser CDP Platform

Direct Chrome DevTools Protocol integration operating without selenium or heavy browser drivers:

• Background tab pooling and isolated context groups.
• Semantic form inspection, automated cookie debugging, and high-fidelity 4K capture.
• Zero browser theft: runs seamlessly in the background while human operators continue work.

Single-Use Action Tokens

Destructive actions (modifying system files, sending communications, triggering external payments) require cryptographic verification. Piron AI generates single-use HMAC tokens valid for 10 minutes that require explicit human approval before execution.