neural-ui-mcp 0.2.5 → 0.3.0

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.
Files changed (13) hide show
  1. package/README.md +22 -12
  2. package/data/charts-native-catalog.json +1 -0
  3. package/data/charts-native-sha256 +1 -0
  4. package/data/native-catalog.json +1 -1
  5. package/data/native-sha256 +1 -1
  6. package/dist/catalog.d.ts +3 -1
  7. package/dist/catalog.js +18 -6
  8. package/dist/release-versions.d.ts +3 -3
  9. package/dist/release-versions.js +3 -4
  10. package/dist/server.d.ts +2 -2
  11. package/dist/server.js +13 -12
  12. package/dist/usage-validator.mjs +5 -2
  13. package/package.json +2 -2
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.5** incorpora **@neural-ui/native 0.1.0-beta.6**, incluida su háptica opcional, mediante `library: "native"`. Native está alineada con Angular Native **0.21.0**. Web mantiene **@neural-ui/core 2.0.4** como catálogo predeterminado. Licencia MIT. Node **22.22.3 o posterior**.
3
+ Servidor MCP oficial de Neural UI v2, Neural Native y Neural Charts Native. Es local y de solo lectura. La versión **0.3.0** añade **@neural-charts/native 0.1.0-beta.3** con `library: "charts-native"`. Conserva **@neural-ui/native 0.1.0-beta.7** con `library: "native"` y **@neural-ui/core 2.0.4** con `library: "web"` como catálogo predeterminado. Licencia MIT. Node **22.22.3 o posterior**.
4
4
 
5
- [neural-ui-mcp@0.2.5](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.3.0](https://www.npmjs.com/package/neural-ui-mcp) incluye los tres 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
- La misma instalación sirve para Web y Native. Selecciona Native explícitamente al llamar a las herramientas.
9
+ La misma instalación sirve para los tres catálogos. Selecciona `native` para los componentes de Neural Native y `charts-native` para gráficas nativas.
10
10
 
11
11
  ```sh
12
- npx --yes neural-ui-mcp@0.2.5
12
+ npx --yes neural-ui-mcp@0.3.0
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.5`. La instalación, el binario y el arranque con npx se comprueban con un cliente MCP real. [Publicaciones y artefactos verificados](https://github.com/PedroMorenoTrujillo/neural-ai/releases).
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.3.0`. La instalación, el binario y el arranque con npx se comprueban con un cliente MCP real. [Publicaciones y artefactos verificados](https://github.com/PedroMorenoTrujillo/neural-ai/releases).
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.5.tgz
25
+ npm install --prefix /ruta/absoluta/neural-mcp-local ./dist/mcp/neural-ui-mcp-0.3.0.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.5
38
- claude mcp add --transport stdio neural-ui -- npx --yes neural-ui-mcp@0.2.5
37
+ codex mcp add neural-ui -- npx --yes neural-ui-mcp@0.3.0
38
+ claude mcp add --transport stdio neural-ui -- npx --yes neural-ui-mcp@0.3.0
39
39
  ```
40
40
 
41
41
  Para una instalación local del tarball:
@@ -75,15 +75,15 @@ Sintaxis contrastada con [Codex MCP](https://developers.openai.com/codex/mcp/) y
75
75
  | `list_components` | `query?`, `kind?`, `offset?`, `limit?` | Selector, clase e import público; hasta 50 resultados por página |
76
76
  | `get_api` | `entrypoint`, `symbol?` | Exports o contrato completo, hash y ubicación de tipos |
77
77
  | `search_documentation` | `query`, `limit?` | Búsqueda local, hasta 10 fragmentos y URI de la referencia completa |
78
- | `get_example` | `id`: forms, table, navigation, overlays, theme | Fuente del ejemplo validado |
78
+ | `get_example` | `id` del ejemplo en el catálogo seleccionado | 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.6`. 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.7`. 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.6","entrypoint":"@neural-ui/native/input","symbol":"NeuInputComponent"}
86
+ {"library":"native","version":"0.1.0-beta.7","entrypoint":"@neural-ui/native/input","symbol":"NeuInputComponent"}
87
87
  ```
88
88
 
89
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.
@@ -92,6 +92,16 @@ Recursos fijos: `neural-ui://docs/references/forms`, el resto de referencias baj
92
92
 
93
93
  Native usa el espacio separado `neural-native://docs/references/forms` y `neural-native://examples/examples/forms`. La búsqueda de una biblioteca no devuelve documentos de la otra. Todos los URI Web existentes se conservan.
94
94
 
95
+ ## Neural Charts Native
96
+
97
+ Usa `library: "charts-native"` y `version: "0.1.0-beta.3"`. Los tres puntos de entrada son `@neural-charts/native`, `@neural-charts/native/plan` y `@neural-charts/native/interaction`.
98
+
99
+ - `get_api` consulta componentes y tipos como `NativeDataChart`, `NativeChartOptions` y `NativeHeatmapData`.
100
+ - `get_example` admite `line`, `customization`, `heatmap`, `panels` y `drilldown`.
101
+ - `search_documentation` devuelve recursos bajo `neural-charts-native://docs/`.
102
+
103
+ La skill está en `skills/neural-charts-native` dentro del [repositorio de Neural AI](https://github.com/PedroMorenoTrujillo/neural-ai). Consulta la [documentación pública](https://charts-native.neuralui.org/) para ver la integración y las demos.
104
+
95
105
  ## Límites y seguridad
96
106
 
97
107
  - Solo texto y recursos empaquetados. No lee proyectos, `.env`, rutas o URL suministradas; no importa ni ejecuta código enviado. No abre puertos, solicita roots, hace sampling ni escribe archivos durante la ejecución.
@@ -103,6 +113,6 @@ Native usa el espacio separado `neural-native://docs/references/forms` y `neural
103
113
 
104
114
  ## Mantenimiento
105
115
 
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 0.1.2 conserva su alcance; la skill Native 0.1.2 mantiene su catálogo separado. 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.
116
+ Los catálogos se construyen con `evidence/api.json`, `evidence/native-api.json` y `evidence/charts-native-api.json`, las referencias y ejemplos de cada skill y `shared/usage-validator.mjs`. `npm run verify:mcp` comprueba los tres catálogos y verifica los hashes del paquete. La skill Web 0.1.2 conserva su alcance; la skill Native 0.1.3 mantiene su catálogo separado. 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
117
 
108
118
  Arquitectura, pruebas y publicación: [docs/mcp.md](https://github.com/PedroMorenoTrujillo/neural-ai/blob/main/docs/mcp.md).