Serveur MCP
Le serveur MCP de GenPM donne à votre agent le même moteur que le CLI : il peut rechercher, inspecter et injecter des modules, et il demande avant de toucher à quoi que ce soit en dehors de votre code.
Le plus rapide est de laisser GenPM écrire la configuration des clients qu’il détecte dans votre projet :
genpm mcp setupIl affiche la modification exacte et demande avant d’écrire. Utilisez --client et --scope pour en choisir un, ou configurez à la main ci-dessous.
Le serveur est intégré au binaire genpm : votre client lance genpm mcp serve, sans Node.js. Sans le binaire, utilisez le paquet npm : remplacez genpm mcp serve par npx -y @genpm-net/mcp ("command": "npx", "args": ["-y", "@genpm-net/mcp"]) dans les exemples ci-dessous ; genpm mcp setup lancé via npm ou npx le fait pour vous.
Claude Code
claude mcp add genpm -- genpm mcp serveCela l’enregistre pour votre utilisateur. Pour le partager avec votre équipe, committez un .mcp.json à la racine du projet (genpm mcp setup --client claude --scope project l’écrit) :
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}Cursor
Projet : .cursor/mcp.json. Utilisateur : ~/.cursor/mcp.json.
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}genpm mcp setup --client cursor # projet
genpm mcp setup --client cursor --scope user # utilisateurVS Code (GitHub Copilot)
Projet : .vscode/mcp.json (notez la clé servers et le type) :
{
"servers": {
"genpm": { "type": "stdio", "command": "genpm", "args": ["mcp", "serve"] }
}
}Utilisateur :
code --add-mcp '{"name":"genpm","command":"genpm","args":["mcp","serve"]}'Windsurf
Utilisateur uniquement : ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}genpm mcp setup --client windsurfCodex
Utilisateur uniquement : ~/.codex/config.toml.
[mcp_servers.genpm]
command = "genpm"
args = ["mcp", "serve"]genpm mcp setup --client codexGemini CLI
Projet : .gemini/settings.json · Utilisateur : ~/.gemini/settings.json. Seul mcpServers est modifié ; vos autres réglages Gemini restent tels quels.
{ "mcpServers": { "genpm": { "command": "genpm", "args": ["mcp", "serve"] } } }genpm mcp setup --client gemini --scope projectServeur distant (lecture seule)
Les clients qui prennent en charge les serveurs MCP distants en Streamable HTTP peuvent se connecter à https://mcp.genpm.net sans rien installer. Il ne propose que genpm_search et genpm_info (ni fichiers ni identifiants) : pour installer, l’agent vous donne la commande genpm add, ou vous passez au serveur local ci-dessus.
{ "mcpServers": { "genpm": { "url": "https://mcp.genpm.net" } } }Outils
| Outil | Rôle |
|---|---|
genpm_search |
Cherche des paquets selon le besoin. Ne renvoie jamais de résultats sponsorisés. |
genpm_info |
Manifeste, dépendances, variables d’environnement, serveurs MCP et règles IA. |
genpm_add |
Planifie (dryRun: true) et injecte. allowMcp et installNpmDeps exigent votre accord. |
genpm_list |
Paquets installés avec leurs modifications locales. |
genpm_remove |
Retire un paquet ; ne supprime jamais du code que vous avez modifié. |
genpm_outdated |
Versions plus récentes disponibles. |
genpm_diff |
Correctif amont d’un paquet installé et vos changements locaux. |
genpm_update |
Met à jour par fusion à trois voies, ou enregistre un correctif déjà appliqué par l’agent (strategy: "ai"). |
genpm_audit |
Intégrité, signatures et avis de sécurité. |
genpm_validate |
Valide un paquet que vous créez. |
Le serveur n’a ni force, ni publish, ni login. Les règles des paquets sont renvoyées comme contenu tiers (<package-rules trust="third-party">) : elles décrivent un module et n’autorisent jamais d’action que vous n’avez pas demandée.
Prompts
genpm-find: recherche → info → simulation → confirmation → installation.genpm-integrate: lit<d>/AGENTS.mdet intègre le module dans l’application.
Serveurs MCP déclarés par les paquets
Un paquet peut déclarer les serveurs MCP dont il a besoin (par exemple celui de Stripe). Ils ne sont jamais ajoutés en silence : genpm add demande d’abord, --no-mcp les ignore et vous pouvez les ajouter plus tard avec genpm mcp add <paquet>. Les secrets sont référencés comme variables d’environnement (${STRIPE_SECRET_KEY} dans .mcp.json, ${env:STRIPE_SECRET_KEY} dans Cursor et VS Code), jamais écrits en clair.
Dépannage
- Le client ne voit pas les outils : redémarrez le client après avoir modifié sa configuration ; vérifiez que
genpm mcp servedémarre dans un terminal (il attend une entrée ; arrêtez-le avec Ctrl+C). - Le client ne trouve pas
genpm: certaines applications ne lisent pas lePATHde votre shell. Utilisez le chemin absolu comme commande :which genpml’affiche sur macOS et Linux (par exemple/Users/vous/.genpm/bin/genpm),where.exe genpmsous Windows. - Télémétrie : définissez
GENPM_TELEMETRY=0(ouDO_NOT_TRACK=1) dans leenvdu serveur. - Un autre registry : définissez
GENPM_REGISTRYdans leenvdu serveur.