MCP server de uidx
Commit 14 nov 2026Permite que agentes de IA y humanos diseñen y editen de forma colaborativa espacios de trabajo visuales utilizando archivos JSX con capacidad de diff almacenados directamente en el repositorio de un proyecto.
También conocido como uidxkit/uidx
- Stars
- 13
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 14 nov 2026
- Licencia
- MIT
¿Qué es uidx MCP?
Permite que agentes de IA y humanos diseñen y editen de forma colaborativa espacios de trabajo visuales utilizando archivos JSX con capacidad de diff almacenados directamente en el repositorio de un proyecto.
Resumen generado a partir del README del proyecto
Acerca del MCP server de uidx
uidx permite a desarrolladores y agentes de IA diseñar espacios de trabajo visuales directamente dentro del repositorio de tu aplicación. Al instalar @uidxkit/uidx como una dependencia de desarrollo local, puedes gestionar diseños a través de archivos JSX con capacidad de diff almacenados en una carpeta .uidx. Este enfoque te permite versionar tus activos de diseño, fuentes y layouts junto con el código de tu aplicación usando Git.
Los usuarios interactúan con el sistema a través de un visor local y un canvas que se sincroniza con los archivos del proyecto. La configuración se ejecuta en tu máquina y no requiere un servicio de diseño alojado ni un LLM para la sincronización del canvas. Para conectar un cliente de IA, utilizas el archivo .mcp.json generado para lanzar el script uidx:mcp, que actúa como un puente stdio hacia el servidor del proyecto en ejecución. Esta configuración permite que herramientas externas inspeccionen y editen los mismos archivos de diseño que los humanos utilizan en el inspector visual.
Qué puedes hacer con él
- 1Edición de diseño colaborativaUn agente de IA puede modificar los archivos de diseño en tu repositorio para actualizar layouts o estilos.
- 2Sistemas de diseño con control de versionesLos desarrolladores pueden gestionar componentes, variantes y design tokens utilizando flujos de trabajo estándar de Git.
- 3Gestión de espacios de trabajo visualesPuedes crear nuevas páginas y ajustar layouts utilizando un canvas visual y un inspector.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleuidxkit/uidx is public and reachablegithub.com/uidxkit/uidx ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-14github.com/uidxkit/uidx ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubWorkflow illustration: one design, shared by the canvas, your files, and your tools.
What is UIDX?
UIDX brings a design canvas into your application's repository. Install
@uidxkit/uidx as a local development dependency, run npm run uidx, and
work on designs stored in your project's .uidx/ folder.
A .uidx file combines Markdown describing a design's purpose with a declarative
node tree describing its appearance. Edit the canvas and the file updates. Edit
the file and the canvas follows. Changes produce focused text diffs you can
review in a pull request.
- A visual workspace. Create pages, draw shapes, edit text, and adjust layout and styling from the canvas and inspector.
- Reusable design systems. Components, instances, variants, slots, and design tokens share a document namespace.
- Your project owns the files. Keep designs, assets, and fonts next to your application and version them with Git.
- A shared workflow for people and agents. The CLI and MCP bridge let external tools inspect and edit the same files the viewer uses.
- Local by default. The viewer and project server run on your machine. Canvas synchronization does not require an LLM or a hosted design service.
UIDX is an early release. The file format and APIs may change before 1.0. It is a design workspace; it does not render your application's existing UI components as Storybook stories.
Install
Requires Node.js 22.19 or newer. Node 24 is recommended.
Run these commands inside your application's repository:
npm install --save-dev @uidxkit/uidx
npm run uidx
Installation adds the uidx and uidx:mcp scripts and creates .uidx/ when it
doesn't exist. Existing scripts, configuration, and designs are preserved.
The CLI, server, viewer, WASM, and bundled fonts live in your project's
node_modules; a global UIDX installation is not required.
Recent npm versions do not run a package's install script until you approve
it, and warn with install scripts not yet covered by allowScripts. Nothing is
lost: the first npx uidx dev performs the same setup itself and says so, or
approve the script with npm install-scripts approve @uidxkit/uidx and
reinstall. To set up explicitly, run npx --no-install uidx init. If your
project already uses a script named uidx, choose another with
npx --no-install uidx init --script design, then run npm run design.
Your design workspace
your-project/
├── package.json # @uidxkit/uidx devDependency and npm scripts
├── .mcp.json # connection for MCP clients
├── src/
└── .uidx/
├── config.json # project settings
├── uidx.json # document name, page patterns, and asset patterns
├── welcome.uidx # initial page for a new workspace
├── assets/
└── fonts/
Open the viewer, click New page, give it a name, and start designing. New
pages are saved in your design folder and appear in the overview. Commit your
project's .uidx/ files alongside application code.
Configuration
Set the shared viewer and MCP port in .uidx/config.json:
{
"port": 4400
}
Restart npm run uidx after changing it. Use npm run uidx -- --port 4500 for a
one-time override. If the requested port is busy, UIDX tries the next available
one and reports its actual address. Configuration currently uses JSON.
The separate .uidx/uidx.json manifest controls which files belong to the document:
{
"id": "my-project",
"files": ["**/*.uidx"],
"assets": ["assets/**"]
}
CLI and MCP
npm run uidx starts the local viewer, file synchronization server, and MCP HTTP
endpoint on one port. MCP clients use the generated .mcp.json to launch
npm run --silent uidx:mcp, a stdio bridge to that running project server.
npx --no-install uidx status
npx --no-install uidx check
npx --no-install uidx fmt --check
The CLI also supports reading, creating, editing, and rendering pages. See the CLI guide and agent architecture.
Documentation
- Drawing icons and custom graphics
- Fonts
- Property vocabulary
- Architecture decisions
- Release guide
- Changelog
Contributing and license
Bug reports, documentation improvements, and pull requests are welcome.
See Contributing for development setup and checks.
Follow the Code of Conduct and report vulnerabilities through
the security policy. Changes to main are merged by the owner.
UIDX is MIT licensed. Third-party code and fonts retain their respective licenses.
Preguntas sobre uidx MCP
¿Cómo instalo UIDX en mi proyecto?
Instálalo como una dependencia de desarrollo local usando npm install --save-dev @uidxkit/uidx y luego ejecuta npm run uidx.
¿Requiere UIDX un servicio de diseño alojado o un LLM para la sincronización?
No, el visor y el servidor del proyecto se ejecutan localmente en tu máquina y no requieren un LLM ni un servicio alojado para la sincronización del canvas.
¿Puedo usar UIDX con agentes de IA?
Sí, el puente MCP permite que herramientas y agentes externos inspeccionen y editen los mismos archivos de diseño que utiliza el canvas visual.
¿Cuáles son los requisitos del sistema para UIDX?
Necesitas la versión 22.19 de Node.js o superior, aunque se recomienda Node 24.