Neon3 AI Authoring MCP

Научите ИИ правильно строить интерфейсы Neon3, а затем позвольте Neon3 проверить результат.

Это MCP-сервер, подробный навык авторинга и стартовый набор для Python/Node для Neon3. Он объединяет три слоя:

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

MCP никогда не создаёт второй UI-язык. neon3_nui_validate вызывает боевой парсер/компилятор neon-ui-runtime, а живые изменения используют существующий контракт neon3.rpc с префиксом длины.

Основные возможности

Требования

• Node.js 20 или новее.

• Neon3, клонированный по пути D:\Neon3 на Windows, или переменная NEON3_ROOT, указывающая на другой клон.

• Один раз соберите авторизованный пробник Neon3:

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

Этот пробник — мост совместимости между этим MCP-пакетом и конкретным клоном Neon3. Он возвращает структурированный JSONL и использует тот же парсер/компилятор, что и работающий UI-рантайм.

Установка из исходного кода

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

Теперь команда доступна как neon3-mcp.

Установка через npm

Когда будет опубликовано:

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

Для фиксированной локальной установки:

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

Конфигурация OpenCode

Добавьте запись MCP в конфигурацию OpenCode:

{
  "$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"
      }
    }
  }
}

Скинируйте skill/SKILL.md в каталог навыков хоста или добавьте этот репозиторий как источник навыков. Skill отделён от MCP-сервера, поэтому его правила авторинга остаются доступными, даже когда Neon3 оффлайн.

MCP также предоставляет тот же материал в виде ресурсов:

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

Claude Desktop / MCP-клиенты

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

Инструменты

Цикл авторинга

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

Пример валидного типизированного семантического 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 не должен содержать fetch, callbacks, Python-код, пути к файлам, координаты, GPU-handle, или выражения произвольного вида.

Шаблоны

templates/python-app и templates/node-app включают:

• метаданные приложения neon3.app.json

• типизированный декларативный UI в ui/main.nui

• минимальный RPC-клиент с перефиксом длины

• детерминированый протоколтест или синтаксическую проверку

The neon3_app_init tool writes only at the root NEON3_APP_ROOT (or in the current directory if this variable is not set).""" Wait that was English accidentally. Need translate:

"Инструмент neon3_app_init создаёт файлы только в пределах NEON3_APP_ROOT (или в текущей рабочей директoрии, если переменная не задана)."

I accidentally included English sentence. In final, be careful. I'll correct.

"Инструмент neon3_app_init записывает только в NEON3_APP_ROOT (или в текущую рабочую папку, если эта переменная не установлена)."

Good.

"## Валis" etc.

Let's now produce final with fixed. No more mis. Need final output directly.

Let's carefully reconstruct full final from scratch to avoid mistakes. Need not show internal. Let's create clean final.

Potential problem: I had "Messaging". Ok.

Let's compose final fully.

One note: The final should not include "MCP" link? It includes "OpenCode". All good.

Let's ensure "URLs" and "links" preserved exactly:

• Neon3

• LICENSE

• Badge src, license link.

Keep scripts\run-neon-services.ps1, neon-dev.

Need "loop" fact.

Let's write final now# Neon3 AI Authoring MCP

Научите ИИ правильно строить интерфейсы Neon3, а затем позвольте Neon3 проверить результат.

Это MCP-сервер, детальный навык авторинга и стартовый набор для Python/Node для Neon3. Он объединяет три слоя:

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

MCP никогда не создаёт второй UI-язык. neon3_nui_validate вызывает продакшн-парсер/компилятор neon-ui-runtime, а «живые» изменения используют существующий контракт neon3.rpc с префиксом длины.

Основное

Требования

• Node.js 20 или новее.

• Neon3 получает приём в D:\Neon3 на Windows, или NEОN3_ROOT to be set to another copy.

• Соберите однажды authoring probe Neon3:

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

Probe — это мост совместимости между данным MCP-пакетом и конкретным снимком Neon3. Он возвращает структурированный JSONL, используя тот же парсер/компилятор, что и работающий UI-рантайм.

Установка из исходников

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

Команда теперь доступна как neon3-mcp.

Установка из npm

После публикации:

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

Для фиксированной локальной установки:

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

Конфигурация OpenCode

Добавьте MCP запись в конфигурацию OpenCode:

{
  "$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"
      }
    }
  }
}

Скопируйте skill/SKILL.md в каталог skills хоста, или добавьте этот репозиторий как источник Skill. Навык отделён от MCP-сервера, поэтому его правила авторизации будут доступны даже когда Neon3 недоступен.

Также MCP предоставляет те же материалы в виде ресурсов:

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"
      }
    }
  }
}

Инструменты

Цикл авторинга

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

Пример валидного, типизированного, семантического 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 не должен содержать fetch, callbacks, Python-код, путей к файлам, координат, GPU- by handles, или произвольных выражений.

Шаблоны

templates/python-app и templates/node-app включают:

• neon3.app.json — метаданные приложения

• ui/main.nui — типизированный декларативный UI

• минимальный length-prefixed RPC-клиент

• детерминированный тест протокола или проверка синтаксиса

Инструмент neon3_app_init записывает только в NEON3_APP_ROOT (или в текущую каталог-projects, когда переменная не задана).

Валидация NUI без запущенного рантайма

$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

Процесс выводит JSONL. Ошибка parser или компилятора возвращает exit code 1 и включает стабильные диагностики и исходные диапазоны.

Запуск headless-сервисов Neon3

Используйте существующий запускатор Neon3. MCP не создаёт молчаливый второй рендерер:

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

Затем вызывайте neon3_capabilities, neon3_ui_snapshot или neon3_nui_submit из ИИ-клиента.

Конфигурация

Все «живые» endpoint должны быть loopback. MCP не предоставляет инструмент для произвольной команды shell.

Troubleshooting

authoring probe не может запуститься

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

Ревизии_conflict

Вызовите neon3_ui_snapshot, используйте возвращённую авторитетную ревизцию и отправьте ещё раз. Не повторяйте монтоную слепую stale mutation.

Сервис недоступен

Проверьте endpoint в neon3_capabilities. Запустите Neon3 через scripts\run-neon-services.ps1 или используйте neon-dev для оконного запуска.

Развитие

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

Тест протокола использует deterministic local fake Neоб3 endpoint и проверяет request IDs, фраing и структурированный JSON-вывод. Настoshщaя граница NUI проверяется neon3_authoring_probe в репозитории Neоб3.

Связ проект

Этот репозиторий — слой ИИ-интеgrации. Neon3 остаётся владельцем протокола, NUI-грамматаки, UI-раната, WGPU-раната и авторитетом проекта:

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

• Neоб3: https://github.com/unco99/Neоб3-CiJian

Лицензия

MIT. Смотрите LICENSE.