Numbers Native

Numbers Native

Sitio web · Descargar · Italiano · Registro MCP · Soporte

Herramientas nativas de Apple Numbers para Codex, por Viames Marino. Código abierto bajo la Licencia MIT.

Numbers Native permite a Codex crear, inspeccionar y editar documentos .numbers reales a través de la aplicación Apple Numbers. Numbers realiza los cálculos y guarda su propio formato nativo. No se involucra conversión de Excel, bibliotecas XLSX, escritores de archivos de ingeniería inversa, servicios MCP remotos ni claves API adicionales de OpenAI.

La versión 0.5.0 es una vista previa. La verificación nativa local y las comprobaciones de portabilidad no establecen compatibilidad en todos los Mac. Consulte verificación y cobertura de funciones.

Requisitos

• Un Mac con Apple Numbers instalado, en una sesión gráfica con sesión iniciada.
• Node.js 22 o posterior, disponible en el PATH del host de Codex.
• Un entorno Codex que admita servidores MCP stdio locales y mercados de complementos.
• Permiso para que el host real que muestra macOS controle Numbers en Configuración del sistema → Privacidad y seguridad → Automatización.

Esta versión utiliza Apple Events y no requiere permiso de Accesibilidad. No puede ejecutar sus herramientas nativas en un ejecutor Linux/Windows o en la nube aislado.

Instalar en Codex

codex plugin marketplace add viames/numbers-native
codex plugin add numbers-native@viames-numbers

Inicie una nueva tarea local de Codex y ejecute la habilidad de configuración. También puede agregar https://github.com/viames/numbers-native a través de Agregar mercado de complementos en clientes de escritorio compatibles.

El ejemplo sintético muestra un gráfico nativo que se actualiza a Materiali 150 EUR, total 265 EUR y residual 35 EUR.

Descargar una versión

Descomprima la versión de mercado en un directorio permanente. Contiene .agents/plugins/marketplace.json y plugins/numbers-native/. El servidor incluido incluye sus dependencias de JavaScript, por lo que los usuarios no necesitan ejecutar npm install.

Con un CLI de Codex reciente, desde el directorio extraído:

codex plugin marketplace add .
codex plugin add numbers-native@viames-numbers

Inicie una nueva sesión de Codex e invoque @Numbers Native o su habilidad Numbers/setup. En clientes de escritorio que admitan mercados de repositorios, abra este directorio extraído como proyecto y seleccione el mercado Viames Numbers en Complementos. Las versiones del host y las políticas del espacio de trabajo pueden afectar el descubrimiento del mercado; el registro del CLI es explícito.

Si su host de escritorio no puede encontrar node, instale Node.js y asegúrese de que esté en el PATH de ese host. Alternativamente, puede registrar el servidor MCP directamente en la configuración MCP de un cliente compatible, usando la ruta absoluta del servidor extraído:

{
  "mcpServers": {
    "numbers-native": {
      "command": "node",
      "args": ["/absolute/path/to/numbers-native/plugins/numbers-native/dist/server.mjs"]
    }
  }
}

La configuración MCP sin procesar es un respaldo para clientes que admiten MCP stdio; no instala las habilidades del complemento. Configure la conexión MCP directa de Codex con su formato TOML nativo si usa esa ruta. No pegue JSON en config.toml.

Ejecute la configuración y luego pruebe:

Cree un documento nativo de Numbers en mi carpeta elegida, con dos tablas independientes y fórmulas para un presupuesto mensual. Lea los totales y guarde el archivo .numbers.

Inspeccione el documento de Numbers que identifique, encuentre la tabla de Gastos y actualice solo los valores que proporcione.

Cobertura y límites

El complemento expone 38 herramientas MCP tipadas para documentos, plantillas, hojas, tablas, lecturas/escrituras de rangos, fórmulas nativas, formato, borrar/combinar, ordenar/transponer, filas/columnas, selección, búsqueda, texto/formas/imágenes y geometría de objetos existentes. Las exportaciones opcionales de PDF/CSV las realiza el propio Numbers.

La versión 0.5.0 agrega ediciones de celdas de múltiples tablas protegidas, comprobaciones de resultados nativos de solo lectura y agregar/actualizar CSV/TSV tipados. Consulte flujos de trabajo de datos. La versión 0.4.0 agregó copia de seguridad nativa/compañera completa, restauración y mover/renombrar, vistas previas nativas de PDF/PNG (incluidas imágenes guiadas de antes/después) y diagnósticos de compatibilidad local. Consulte flujos de trabajo de archivos/vistas previas. La preservación de formatos compatibles, prototipos personalizados y actualizaciones de origen guiadas siguen disponibles. Conserva los 11 perfiles de gráficos de plantillas nativas. Consulte el nuevo flujo de trabajo. Se admiten gráficos de columnas, barras, circulares, de anillo, radiales, de columnas interactivas, de columnas apiladas, de área, de doble eje, de dispersión y de burbujas. Consulte el flujo de trabajo de gráficos. Los gráficos de doble eje, dispersión y burbujas conservan leyendas de ejes fijas (clima, consumo de combustible y ventas); use sus significados de datos documentados. Los perfiles se verifican para Numbers 14.5 y fallan explícitamente en versiones no verificadas o estructuras de plantilla cambiadas.

Las llamadas de lectura/escritura están limitadas a 2,000 celdas, las llamadas de insertar/eliminar filas/columnas a 100 elementos. Pagine a través de tablas grandes. Las cadenas simples son texto literal, incluidos = iniciales y ceros a la izquierda. Las fórmulas requieren { "formula": "=SUM(B2:B5)" }. Las fechas requieren { "date": "2026-10-18T10:30:00Z" }. Los booleanos usan celdas de casillas de verificación nativas. Numbers puede devolver fórmulas y valores formateados en el idioma actual del documento.

Los gráficos se pueden crear en documentos nuevos a partir de perfiles de plantilla verificados, con hasta 100 puntos y límites específicos del perfil de 1 a 10 columnas numéricas. Las celdas de origen siguen siendo editables con las herramientas normales de Numbers; Numbers actualiza el gráfico conectado. El tipo de gráfico, las referencias de series, los colores, el título interno y la inserción arbitraria en documentos existentes no están expuestos. Un encabezado opcional es un elemento de texto nativo separado. La creación de tablas dinámicas, reglas condicionales, comentarios, colaboración, contraseñas, formatos de número detallados y duplicación nativa siguen sin ser compatibles.

Numbers guarda automáticamente. Las escrituras no son atómicas y pueden aplicarse parcialmente. Las múltiples llamadas en un servidor y entre servidores de complementos cooperantes se serializan, pero el usuario y otras aplicaciones aún pueden editar simultáneamente. Inspeccione el estado después de errores; nunca reintente automáticamente mutaciones con tiempo de espera agotado. El complemento deja abiertos documentos no relacionados.

Privacidad y ejecución local

El puente MCP no realiza solicitudes de red, no escucha en un puerto de red, no recopila telemetría ni sube documentos a un servicio separado. Las entradas y los resultados pasan a través de Codex y pueden enviarse a su modelo según las políticas del host. La automatización local no significa que todos los datos de la hoja de cálculo permanezcan en el dispositivo.

De forma predeterminada, las herramientas pueden acceder a rutas locales seleccionadas explícitamente y documentos abiertos identificados. Para restringir el acceso, establezca NUMBERS_NATIVE_ALLOWED_ROOTS en el entorno del servidor MCP a una matriz JSON de directorios absolutos existentes:

{ "NUMBERS_NATIVE_ALLOWED_ROOTS": "[\"/Users/your-user/Documents/Numbers\"]" }

Las rutas se canonizan para rechazar escapes de enlaces simbólicos. Esta es una verificación adicional del puente, no un sandbox del sistema operativo para Numbers en sí. Numbers puede resolver sus propias dependencias de archivos. Detalles de privacidad.

Desarrollar y verificar

npm ci
npm test
npm run build
npm run test:native
npm run test:charts
npm run test:guided
npm run test:files
npm run test:workflows
npm run package

test:native inicia Numbers, crea sus propios documentos temporales y prueba sus resultados nativos. Nunca usa documentos de usuario como accesorios. Necesita permiso de GUI/Automatización y es separado del CI portátil. Las pruebas unitarias/MCP se ejecutan en otros sistemas operativos; las operaciones nativas no.

El proceso de lanzamiento crea un ZIP de mercado y un ZIP de complemento independiente con runtime incluido, habilidades, trabajador nativo, avisos y licencia, además de sumas de verificación SHA-256. Los mantenedores reconstruyen desde el archivo de bloqueo fijado. El código fuente sin empaquetar también se incluye en el complemento independiente para inspección; el ZIP de mercado contiene el repositorio de código fuente completo.

Distribución pública

El mercado de código fuente público es viames/numbers-native. Las versiones con versión incluyen el ZIP de mercado de Codex, el ZIP de complemento independiente, un paquete .mcpb de macOS, metadatos de registro y sumas de verificación SHA-256. Los clientes MCPB reciben las mismas herramientas nativas; el complemento de Codex también incluye habilidades. La identidad oficial del Registro MCP es io.github.viames/numbers-native; verifique su registro en vivo en lugar de asumir que un envío de registro ha tenido éxito. La distribución de repositorio/registro es separada de la inclusión en el directorio oficial de OpenAI.

Según lo verificado el 18 de octubre de 2026, las reglas de envío solo de escritorio de OpenAI restringen los envíos MCP locales a socios aprobados y requieren que la organización que envía esté en la lista de permitidos. Un paquete funcional no es prueba de elegibilidad o aprobación en el directorio. Consulte pasos de publicación.

Numbers Native es un proyecto independiente y no está afiliado ni respaldado por Apple u OpenAI. Apple Numbers es necesario y no está incluido.