Aller au contenu
Documentation : Serveur MCP du registre

Serveur MCP du registre

Cherchez et installez des éléments en le demandant à votre outil d'IA, avec un plan que vous voyez d'abord.

La documentation fournie avec Ronne AI Marketplace 0.3.0, traduite de l'anglais.

Ce qu'il fait

Le serveur MCP du registre, rmk-mcp, permet à votre outil d'IA (Claude Code, Codex, Cursor, ou tout outil qui parle MCP) de faire ce que fait rmk, depuis la conversation. Demandez-lui de trouver un skill pour réviser du SQL, d'expliquer ce qu'un élément changerait, ou de tout mettre à jour, et l'assistant utilise les outils du serveur.

Il s'exécute sur votre machine, lancé par l'outil d'IA dans le dossier de votre projet, et lit ce marketplace en votre nom, avec le jeton de rmk login. Il utilise le code même de rmk; il résout, fait le rendu et écrit donc exactement comme rmk, et rmk.lock et le fichier d'état restent les mêmes, quel que soit celui que vous utilisez.

Il peut aussi envoyer à ce marketplace, comme brouillon privé, un élément que vous avez écrit dans votre outil d'IA, comme le fait rmk export. La revue, la soumission et la publication restent sur ce site.

Le configurer

  1. Obtenez-le. npm install --global @ronneai/rmk @ronneai/mcp installe rmk et rmk-mcp (Node.js 22.12 ou plus récent). Vous utilisez plutôt une copie du dépôt? Après pnpm build, le serveur est packages/mcp/dist/bin.js : enregistrez-le par son chemin avec --command, ci-dessous.
  2. Connectez-vous avec rmk login, si ce n'est pas déjà fait : le serveur utilise ce jeton.
  3. Enregistrez-le dans chaque outil d'IA, depuis le dossier du projet :
rmk mcp-setup                # for the tools this project uses
rmk mcp-setup --target all    # for every tool rmk knows
rmk mcp-setup --scope user    # in your home folder, for every project
rmk mcp-setup --command "node /path/to/packages/mcp/dist/bin.js"
rmk mcp-setup --remove

rmk mcp-setup ajoute le serveur aux réglages MCP de chaque outil sous le nom ronne-registry (.mcp.json pour Claude Code, .codex/config.toml pour Codex, .cursor/mcp.json pour Cursor), et le consigne comme tout réglage qu'écrit rmk : les installations n'y touchent pas, --remove retire exactement celui-là, et il ne remplace jamais une entrée que vous avez créée.

Redémarrez ensuite l'outil, ou rechargez ses serveurs MCP. Claude Code demande une fois avant d'utiliser les serveurs MCP d'un projet, et Codex ne lit .codex/config.toml que dans un projet auquel vous faites confiance.

Les outils

OutilCe qu'il faitÉcrit ou envoie
search_itemsTrouve des éléments par nom, description ou mot-clé; aussi par type, portée ou outil d'IA.Rien
get_itemLes étiquettes et les versions d'un élément, et les dépendances d'une version, ses signaux de risque, les outils où elle fonctionne et son README.Rien
list_installedCe que contient le fichier de verrouillage, et les éléments que vous avez demandés.Rien
check_outdatedPour chaque élément demandé : la version verrouillée, la plus récente que permet sa plage, la plus récente publiée.Rien
plan_installPlanifie l'installation d'éléments, avec @tag ou @range au besoin.Rien
plan_updatePlanifie la mise à jour d'éléments, ou de tous, dans leurs plages.Rien
plan_removePlanifie le retrait d'éléments, et de ce dont plus rien n'a besoin.Rien
apply_planÉcrit un plan fait dans les 10 dernières minutes, une seule fois.Les fichiers du plan, le fichier de verrouillage et l'état
list_local_itemsLes skills, agents, commandes, règles et serveurs MCP dans les dossiers de Claude Code, de Codex et de Cursor, avec l'outil auquel chacun est destiné, et à qui chacun appartient : à vous, installé (modifié ou non), une copie du registre, ou écrit par rmk. Accepte type et from.Rien
plan_exportPlanifie l'envoi de vos éléments à ce marketplace comme brouillons : chaque fichier, et ce qui est laissé de côté. Accepte type, from (l'outil), la description d'un serveur MCP, et dependencies (include ou omit) pour vos éléments qu'ils utilisent. Une installation modifiée, ou un élément dont le nom est publié, est planifiée comme proposition de changement, sauf si new est défini.Rien
export_itemsTéléverse un plan d'exportation fait dans les 10 dernières minutes, une seule fois, comme brouillons privés.Envoie les fichiers du plan à ce marketplace
check_draftsIndique lesquels de vos brouillons Submit prendrait maintenant, et ce qui bloque les autres. Accepte items (noms ou identifiants) ou all; vos brouillons dont ils dépendent sont inclus en premier, sauf si dependencies vaut false.Rien
submit_draftsSoumet chacun de ces brouillons qui est prêt, et explique pourquoi les autres ne l'ont pas été.Les envoie aux réviseurs

Trois outils agissent, et votre outil d'IA vous demande votre accord pour eux : apply_plan sur vos fichiers, et export_items et submit_drafts sur ce marketplace. Tous les autres outils sont marqués en lecture seule. list_installed, check_outdated et les outils de plan acceptent scope: user pour votre dossier personnel, et les outils de plan acceptent targets, comme ["codex"], quand le dossier semble destiné à plusieurs outils.

Plans

  1. Planifier. Quand vous lui demandez d'installer, de mettre à jour ou de retirer, l'assistant fait d'abord un plan : les versions, chaque fichier et réglage qu'il écrirait ou retirerait, des avertissements sur ce qu'un outil ne peut pas prendre, ce que chaque nouvel élément peut faire (ses signaux de risque), et les variables d'environnement dont ses serveurs MCP ont besoin. La planification n'écrit rien dans votre projet.
  2. Appliquer. Une fois que vous avez vu le plan, l'assistant l'applique avec apply_plan; votre outil vous le demande avant de l'exécuter, sauf si vous l'avez autorisé. Il écrit exactement ce plan, puis le fichier de verrouillage et le fichier d'état, et indique ce qu'il a écrit.
  • Un plan dure 10 minutes, et n'est appliqué qu'une fois.
  • Si quoi que ce soit que touche le plan change entre-temps, comme une installation depuis le terminal ou un autre outil d'IA, il est refusé comme périmé, et l'assistant refait un plan.
  • Un plan avec des conflits (un fichier ou un réglage que rmk n'a pas écrit, ou qui a changé depuis) ne peut pas être appliqué depuis l'outil d'IA : déplacez-les, ou utilisez rmk install --force dans le terminal, délibérément.

Les plans d'exportation fonctionnent de la même façon : plan_export montre chaque fichier qui serait téléversé et n'envoie rien, et export_items téléverse exactement ce plan, une seule fois, dans un délai de 10 minutes. Si vous modifiez le skill entre-temps, le plan est refusé comme périmé. Les plans d'installation et les plans d'exportation sont séparés : aucun des deux outils n'accepte le plan de l'autre.

Ce à quoi il a accès

  • Il peut faire ce que permet votre jeton : lire ce qui est publié et le télécharger, créer des brouillons en votre nom et les soumettre quand vous le demandez. Il n'affiche jamais le jeton, et il ne peut pas se connecter à ce site.
  • Il n'envoie que des éléments qu'il a trouvés dans les dossiers de vos outils d'IA et qui sont à vous, jamais un dossier que vous nommez, jamais les fichiers que l'exportation laisse de côté ni les identifiants d'un serveur MCP, et seulement quand vous approuvez export_items. Ce qui arrive est un brouillon que vous seul voyez.
  • Il n'écrit que dans le dossier du projet (ou dans votre dossier personnel, avec scope: user), en passant par les mêmes vérifications que rmk, et n'exécute jamais le code d'un élément : les hooks et les scripts sont écrits, pas exécutés.
  • Sans jeton, chaque outil qui accède au marketplace indique de lancer rmk login. Si le marketplace est injoignable, list_installed et list_local_items fonctionnent quand même : ils ne lisent que vos fichiers.