Serveur MCP uidx
Commit 14 nov. 2026Permet aux agents IA et aux humains de concevoir et de modifier collaborativement des espaces de travail visuels à l'aide de fichiers JSX diffables stockés directement dans le dépôt d'un projet.
Aussi connu sous uidxkit/uidx
- Étoiles
- 13
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 14 nov. 2026
- Licence
- MIT
Qu'est-ce que uidx MCP ?
Permet aux agents IA et aux humains de concevoir et de modifier collaborativement des espaces de travail visuels à l'aide de fichiers JSX diffables stockés directement dans le dépôt d'un projet.
Résumé généré à partir du README du projet
À propos du MCP server uidx
La conception d'espaces de travail visuels directement au sein du dépôt de votre application est ce que uidx permet aux développeurs et aux agents IA. En installant @uidxkit/uidx comme dépendance de développement locale, vous pouvez gérer vos designs via des fichiers JSX diffables stockés dans un dossier .uidx. Cette approche vous permet de versionner vos assets de design, vos polices et vos mises en page aux côtés du code de votre application grâce à Git.
Les utilisateurs interagissent avec le système via un viewer local et un canvas qui se synchronise avec les fichiers du projet. L'installation s'exécute sur votre machine et ne nécessite aucun service de design hébergé ni LLM pour la synchronisation du canvas. Pour connecter un client IA, vous utilisez le fichier .mcp.json généré pour lancer le script uidx:mcp, qui agit comme un pont stdio vers le serveur de projet en cours d'exécution. Cette configuration permet aux outils externes d'inspecter et de modifier les mêmes fichiers de design que ceux utilisés par les humains dans l'inspecteur visuel.
Ce que vous pouvez faire avec
- 1Édition de design collaborativeUn agent IA peut modifier les fichiers de design dans votre dépôt pour mettre à jour les mises en page ou les styles.
- 2Systèmes de design avec contrôle de versionLes développeurs peuvent gérer les composants, les variantes et les design tokens en utilisant les workflows Git standards.
- 3Gestion d'espaces de travail visuelsVous pouvez créer de nouvelles pages et ajuster les mises en page à l'aide d'un canvas visuel et d'un inspecteur.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleuidxkit/uidx is public and reachablegithub.com/uidxkit/uidx ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-14github.com/uidxkit/uidx ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur uidx MCP
Comment installer UIDX dans mon projet ?
Installez-le comme une dépendance de développement locale en utilisant npm install --save-dev @uidxkit/uidx, puis lancez npm run uidx.
UIDX nécessite-t-il un service de design hébergé ou un LLM pour la synchronisation ?
Non, le viewer et le serveur de projet s'exécutent localement sur votre machine et ne nécessitent ni LLM ni service hébergé pour la synchronisation du canvas.
Puis-je utiliser UIDX avec des agents IA ?
Oui, le pont MCP permet aux outils et agents externes d'inspecter et de modifier les mêmes fichiers de design que ceux utilisés par le canvas visuel.
Quelle est la configuration système requise pour UIDX ?
Vous avez besoin de Node.js version 22.19 ou plus récente, bien que Node 24 soit recommandé.