neural-ui-mcp 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,18 +1,18 @@
1
1
  # neural-ui-mcp
2
2
 
3
- Servidor MCP oficial de Neural Web y Native, local y de solo lectura. La actualización **0.2.2** alinea Web con **@neural-ui/core 2.0.4** como predeterminado y conserva **@neural-ui/native 0.1.0-beta.2** mediante `library: "native"`. Licencia MIT. Node **22.22.3 o posterior**.
3
+ Servidor MCP oficial de Neural Web y Native, local y de solo lectura. La actualización **0.2.4** incorpora **@neural-ui/native 0.1.0-beta.5**, incluida su háptica opcional, mediante `library: "native"`. Web mantiene **@neural-ui/core 2.0.4** como catálogo predeterminado. Licencia MIT. Node **22.22.3 o posterior**.
4
4
 
5
- [neural-ui-mcp@0.2.2](https://www.npmjs.com/package/neural-ui-mcp) incluye ambos catálogos. La versión anterior 0.1.0 solo cubre Web. No requiere backend, cuenta, claves, conexión de red durante la ejecución ni servicios de IA. La descarga de dependencias sí usa npm. El cliente de IA que elijas mantiene sus propias condiciones de uso.
5
+ [neural-ui-mcp@0.2.4](https://www.npmjs.com/package/neural-ui-mcp) incluye ambos catálogos. La versión anterior 0.1.0 solo cubre Web. No requiere backend, cuenta, claves, conexión de red durante la ejecución ni servicios de IA. La descarga de dependencias sí usa npm. El cliente de IA que elijas mantiene sus propias condiciones de uso.
6
6
 
7
7
  ## Instalar desde npm
8
8
 
9
9
  La misma instalación sirve para Web y Native. Selecciona Native explícitamente al llamar a las herramientas.
10
10
 
11
11
  ```sh
12
- npx --yes neural-ui-mcp@0.2.2
12
+ npx --yes neural-ui-mcp@0.2.4
13
13
  ```
14
14
 
15
- El proceso espera mensajes MCP en stdin. Para instalarlo como dependencia de tu proyecto usa `npm install --save-dev --save-exact neural-ui-mcp@0.2.2`. La instalación, el binario y el arranque con npx se comprueban con un cliente MCP real. [Evidencia de publicación](https://github.com/PedroMorenoTrujillo/neural-ai/blob/main/evidence/mcp/publication.json).
15
+ El proceso espera mensajes MCP en stdin. Para instalarlo como dependencia de tu proyecto usa `npm install --save-dev --save-exact neural-ui-mcp@0.2.4`. La instalación, el binario y el arranque con npx se comprueban con un cliente MCP real. [Evidencia de publicación](https://github.com/PedroMorenoTrujillo/neural-ai/blob/main/evidence/mcp/publication.json).
16
16
 
17
17
  ## Instalar el tarball verificado
18
18
 
@@ -22,7 +22,7 @@ Desde una copia del repositorio [Neural AI](https://github.com/PedroMorenoTrujil
22
22
  npm ci
23
23
  npm ci --prefix packages/mcp
24
24
  npm run verify:mcp
25
- npm install --prefix /ruta/absoluta/neural-mcp-local ./dist/mcp/neural-ui-mcp-0.2.2.tgz
25
+ npm install --prefix /ruta/absoluta/neural-mcp-local ./dist/mcp/neural-ui-mcp-0.2.4.tgz
26
26
  ```
27
27
 
28
28
  El último comando instala el paquete local preparado por las pruebas. Comprueba su SHA-256 con `dist/mcp/SHA256SUMS`. También puedes ejecutar directamente `node /ruta/absoluta/neural-ai/packages/mcp/dist/cli.js` después de compilarlo. El proceso espera a un cliente en stdin.
@@ -34,8 +34,8 @@ Usa un Node compatible disponible para el cliente.
34
34
  Para usar directamente la versión publicada:
35
35
 
36
36
  ```sh
37
- codex mcp add neural-ui -- npx --yes neural-ui-mcp@0.2.2
38
- claude mcp add --transport stdio neural-ui -- npx --yes neural-ui-mcp@0.2.2
37
+ codex mcp add neural-ui -- npx --yes neural-ui-mcp@0.2.4
38
+ claude mcp add --transport stdio neural-ui -- npx --yes neural-ui-mcp@0.2.4
39
39
  ```
40
40
 
41
41
  Para una instalación local del tarball:
@@ -78,15 +78,15 @@ Sintaxis contrastada con [Codex MCP](https://developers.openai.com/codex/mcp/) y
78
78
  | `get_example` | `id`: forms, table, navigation, overlays, theme | Fuente del ejemplo validado |
79
79
  | `validate_usage` | `source`, `filename?` | Errores y advertencias estáticas; `compilationChecked: false` |
80
80
 
81
- Todas aceptan `library: "web" | "native"` (predeterminado `web`) y una versión opcional que debe coincidir con el catálogo: Web `2.0.4`, Native `0.1.0-beta.2`. Las respuestas conservan `{ version, data }`, datos estructurados y texto JSON equivalente. Los errores de mezcla de catálogo o versión se rechazan; no hay conversión implícita. Para proyectos fijados a Core 2.0.3, conserva MCP 0.2.1 y la skill Web 0.1.1; para Core 2.0.1, conserva MCP 0.2.0 y la skill Web 0.1.0 hasta actualizar su baseline. La validación detecta imports internos, símbolos desconocidos, inputs/outputs inexistentes, inputs requeridos ausentes y propietarios de formulario en conflicto, dentro del alcance descrito abajo.
81
+ Todas aceptan `library: "web" | "native"` (predeterminado `web`) y una versión opcional que debe coincidir con el catálogo: Web `2.0.4`, Native `0.1.0-beta.5`. Las respuestas conservan `{ version, data }`, datos estructurados y texto JSON equivalente. Los errores de mezcla de catálogo o versión se rechazan; no hay conversión implícita. Para proyectos fijados a Core 2.0.3, conserva MCP 0.2.1 y la skill Web 0.1.1; para Core 2.0.1, conserva MCP 0.2.0 y la skill Web 0.1.0 hasta actualizar su baseline. La validación detecta imports internos, símbolos desconocidos, inputs/outputs inexistentes, inputs requeridos ausentes y propietarios de formulario en conflicto, dentro del alcance descrito abajo.
82
82
 
83
83
  Ejemplo de argumentos para `get_api`:
84
84
 
85
85
  ```json
86
- {"library":"native","version":"0.1.0-beta.2","entrypoint":"@neural-ui/native/input","symbol":"NeuInputComponent"}
86
+ {"library":"native","version":"0.1.0-beta.5","entrypoint":"@neural-ui/native/input","symbol":"NeuInputComponent"}
87
87
  ```
88
88
 
89
- Native tiene 67 entrypoints, los modelos heredados de sus controles y sus propios contratos de templates. Sus ejemplos son `forms`, `collections`, `navigation`, `overlays` y `theme`; `table` sigue siendo Web. `validate_usage` en Native rechaza imports Web de Neural y controles DOM, y comprueba `pressed` en lugar de aceptar `click` como evento del botón Native.
89
+ Native tiene 68 entrypoints, los modelos heredados de sus controles y sus propios contratos de templates. Sus ejemplos son `forms`, `collections`, `navigation`, `overlays` y `theme`; `table` sigue siendo Web. `validate_usage` en Native rechaza imports Web de Neural y controles DOM, y comprueba `pressed` en lugar de aceptar `click` como evento del botón Native.
90
90
 
91
91
  Recursos fijos: `neural-ui://docs/references/forms`, el resto de referencias bajo `neural-ui://docs/`, y ejemplos bajo `neural-ui://examples/examples/forms` (análogamente para los otros cuatro). Usa `resources/list` para descubrir los URI exactos. La búsqueda devuelve URI completos.
92
92
 
@@ -103,6 +103,6 @@ Native usa el espacio separado `neural-native://docs/references/forms` y `neural
103
103
 
104
104
  ## Mantenimiento
105
105
 
106
- Fuentes únicas: `evidence/api.json` y `evidence/native-api.json`, las referencias/ejemplos de cada skill y `shared/usage-validator.mjs`. `npm run build:mcp` comprueba ambos snapshots y genera los catálogos empaquetados con hashes separados. La skill Web y su release 0.1.0 conservan su alcance. Para actualizar Neural, revisa primero la extracción y los ejemplos, después reconstruye y verifica el MCP. No cambies silenciosamente la versión del catálogo.
106
+ Fuentes únicas: `evidence/api.json` y `evidence/native-api.json`, las referencias/ejemplos de cada skill y `shared/usage-validator.mjs`. `npm run build:mcp` comprueba ambos snapshots y genera los catálogos empaquetados con hashes separados. La skill Web y su release 0.1.1 conservan su alcance. Para actualizar Neural, revisa primero la extracción y los ejemplos, después reconstruye y verifica el MCP. No cambies silenciosamente la versión del catálogo.
107
107
 
108
108
  Arquitectura, pruebas y publicación: [docs/mcp.md](https://github.com/PedroMorenoTrujillo/neural-ai/blob/main/docs/mcp.md).