Neon3 AI Authoring MCP

Bringe einer KI bei, Neon3-Oberflächen korrekt zu erstellen, und lasse dann Neon3 das Ergebnis beweisen.

Ein MCP-Server, eine detaillierte Authoring-Skill sowie ein Python/Node-Starter-Kit für Neon3. Es kombiniert drei Ebenen:

Skill                 durable NUI Flow rules and design boundaries
MCP resources/tools   searchable references, live capability discovery, orchestration
Neon3 runtime         authoritative parser, compiler, revision, and renderer feedback

Der MCP erfindet nie eine zweite UI-Sprache. neon3_nui_validate ruft den Produktions-Parser/Compiler von neon-ui-runtime auf, während Live-Mutationen den vorhandenen längenpräfixierten neon3.rpc-Vertrag verwenden.

Highlights

Voraussetzungen

• Node.js 20 oder neuer.

• Neon3 ist unter Windows in D:\Neon3 ausgecheckt, oder NEON3_ROOT ist auf einen anderen Checkout gesetzt.

• Die Neon3-Authoring-Probe einmalig bauen:

cd D:\Neon3
cargo build -p neon-ui-runtime --bin neon3_authoring_probe

Die Probe ist die Kompatibilitätsbrücke zwischen diesem MCP-Paket und dem exakten Neon3-Checkout. Sie erzeugt strukturierte JSONL-Ausgaben und verwendet denselben Parser/Compiler wie die laufende UI-Runtime.

Installation aus dem Quellcode

git clone https://github.com/unco999/neon3-ai-authoring-mcp.git
cd neon3-ai-authoring-mcp
npm install
npm link

Der Befehl ist nun als neon3-mcp verfügbar.

Installation über npm

Sobald veröffentlicht:

npm install -g @neon3/ai-authoring-mcp
neon3-mcp

Für eine gepinnte lokale Installation:

npm install --save-dev @neon3/ai-authoring-mcp
npx neon3-mcp

OpenCode-Konfiguration

Fügen Sie der OpenCode-Konfiguration einen MCP-Eintrag hinzu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "neon3": {
      "type": "local",
      "command": ["neon3-mcp"],
      "enabled": true,
      "environment": {
        "NEON3_ROOT": "D:\\Neon3",
        "NEON3_UI_ENDPOINT": "127.0.0.1:39102",
        "NEON3_WGPU_ENDPOINT": "127.0.0.1:39103",
        "NEON3_PROJECTD_ENDPOINT": "127.0.0.1:39104"
      }
    }
  }
}

Kopieren Sie skill/SKILL.md in das Skill-Verzeichnis des Hosts oder fügen dieses Repository als Skill-Quelle hinzu. Die Skill ist vom MCP-Server getrennt, damit ihre Authoring-Regeln auch verfügbar bleiben, wenn Neon3 offline ist.

Der MCP stellt dasselbe Material auch als Ressourcen bereit:

neon3://skill
neon3://references/overview
neon3://references/grammar
neon3://references/components
neon3://references/statecharts
neon3://references/interactions
neon3://references/diagnostics

Claude Desktop / MCP-Clients

{
  "mcpServers": {
    "neon3": {
      "command": "neon3-mcp",
      "env": {
        "NEON3_ROOT": "D:\\Neon3",
        "NEON3_UI_ENDPOINT": "127.0.0.1:39102"
      }
    }
  }
}

Werkzeuge

Der Authoring-Kreislauf

reference -> capabilities -> generate NUI -> validate -> inspect -> submit -> diagnose

Beispiel für gültiges, typisiertes, semantisches NUI:

version 1
surface surface.example revision 1
budget nodes=32 bindings=16 instances=16 text=16 glyphs=1024 events=8 clips=64
input title text default text:empty
input can_save bool default false
surface root column w 520 h 240 gap 8 pad 16
  text heading value $title
  button save value "Save" enabled $can_save event document.save

NUI-Flow darf kein fetch, keine Callbacks, keinen Python-Code, keine Dateipfade, keine Koordinaten, keine GPU-Handles und keine beliebigen Ausdrücke enthalten.

Vorlagen

templates/python-app und templates/node-app enthalten:

• neon3.app.json-Datei – Anwendungsmetadaten

• ui/main.nui – typisierte deklarative UI

• einen minimalen längenpräfixierten RPC-Client

• einen deterministischen Protokolltest bzw. eine Syntaxprüfung

Das Werkzeug neon3_app_init schreibt Nur unterhalb von NEON3_APP_ROOT (oder in das aktuelle Build-Verzeichnis, wenn diese Variable nicht gesetzt ist).

NUI ohne laufende Runtime validieren

$source = [string]::Join("`n", (Get-Content .\templates\node-app\ui\main.nui))
$request = @{ request_id = "manual-1"; operation = "validate"; sequence = 1; source = $source } | ConvertTo-Json -Compress
$request | cargo run --quiet -p neon-ui-runtime --manifest-path D:\Neon3\Cargo.toml --bin neon3_authoring_probe

Der Process gibt JSONL aus. Ein Parser- oder Compiler-Fehler liefert den Exitcode 1 und enthält stabile Diagnoseinformationen sowie Quelldaten.

Start der Neon3-Headless-Dienste

Verwenden Sie den vorhandenen Neon3-Launcher. Der MCP erstellt nicht still und leise einen zweiten3 Renderer:

cd D:\Neon3
scripts\run-neon-services.ps1

Rufen Sie anschließend neon3_capabilities, neon3_ui_snapshot oder neon3_nui_submit über den KI-Client auf.

Konfiguration

Alle Live-Endpunkte müssen Loopback-Endpunkte sein. Der MCP legt kein Werkzeug für beliebige Shell-Befehle offen.

Fehlerbehebung

Die Authoring-Probe lässt sich nicht starten

cd D:\Neon3
cargo build -p neon-ui-runtime --bin neon3_authoring_probe
$env:NEON3_ROOT = 'D:\Neon3'

revision_conflict

Rufen Sie neon3_ui_snapshot auf, verwenden Sie die zurückgegebene maßgebliche Revision und senden Sie die Datei erneut. Versuchen Sie nicht, eine veraltete Mutation blind erneut zu senden.

Ein Dienst ist nicht erreichbar

Prüfen Sie den Endpunkt in neon3_capabilities. Starten Sie Neon3 mit scripts\run-no-services.ps1 oder verwenden Sie für neon-dev ein Fenster.

Entwicklung

npm install
npm test
node --check src/index.js
npm pack --dry-run

Der Protokolltest verwendet einen deterministischen, lokalen Fake-Neon3-Endpunkt, der Request-IDs, Framing und strukturierte JSON-Ausgabe verifiziert. Die echte NUI-Grenze wird durch die neon3_authoring_probe im Neon3-Repository verifiziert.

Projektbeziehung

Dieses Repository ist die KI-Integrationsschicht. Neon3 bleibt Inhaber des Protokolls, der NUI-Grammatik, der UI-Runtime, der WGPU-Runtime und der Projekt-Autorität:

• MCP: https://github.com/unco999/neon3-ai-authoring-mcp

• Neon3: https://github.com/unco999/Neon3-CiJian

Lizenz

MIT. Siehe Siehe LICENSE.# Neon3 AI Authoring MCP

Bring einer KI bei, Neon3-Oberflächen korrekt zu erstellen, und lass dann Neon3 das Ergebnis bestätigen.

Ein MCP-Server, eine detaillierte Authoring-Skill und ein Python/Node-Startterkit für Neon3. Es kombiniert drei Ebenen:

Skill                 durable NUI Flow rules and design boundaries
MCP resources/tools   searchable references, live capability discovery, orchestration
Neon3 runtime         authoritative parser, compiler, revision, and renderer feedback

Der MCP erfindet nie eine zweite UI-Sprache. neon3_nui_validate ruft den Produktions-Parser/Compiler von neon3-ui-runtime auf, während Live-Mutationen den vorhandenen längenpäfixierten neon3.rpc-Vertrag verwenden.

Highlights

Anforderungen & Voraussetzungen

• Node.js 20 oder neuer.

• Neon3 ausgecheckt unter D:\Neon3 unter Windows, oder NEON3_ROOT ist auf einen anderen Checkout gesetzt.

• Baue die Neon3-Authoring-Probe einmal:

cd D:\Neon3
cargo build -p neon-ui-runtime --bin neon3_authoring_probe

Die Probe ist die Kompatibilitätsbrücke zwischen diesem MCP-Paket und dem exakten Neon3-Checkout. Sie liefert strukturierte JSONL-Daten und verwendet denselben Parser/Compiler wie die laufende UI-Laufzeit.

Installation aus dem Quellcode

git clone https://github.com/unco999/neon3-ai-authoring-mcp.git
cd neon3-ai-authoring-mcp
npm install
npm link

Der Befehl ist nun als neon3-mcp verfügbar.

Installation über npm

Sobald