Plugin TypeScript Nx

Générer un plugin Nx TypeScript complet avec un serveur Model Context Protocol (MCP) intégré. Ce générateur crée une base pour développer des générateurs personnalisés qui peuvent être utilisés de manière transparente par des assistants IA pour la génération automatisée de code et l’échafaudage de projets.

Utilisation

Générer un plugin Nx

Vous pouvez générer un plugin Nx TypeScript de deux manières :

VSCode

1. Installez le Nx Console VSCode Plugin si ce n'est pas déjà fait
2. Ouvrez la console Nx dans VSCode
3. Cliquez sur Generate (UI) dans la section "Common Nx Commands"
4. Recherchez @aws/nx-plugin - ts#nx-plugin
5. Remplissez les paramètres requis
6. Cliquez sur Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:ts#nx-plugin

yarn

yarn nx g @aws/nx-plugin:ts#nx-plugin

npm

npx nx g @aws/nx-plugin:ts#nx-plugin

bun

bunx nx g @aws/nx-plugin:ts#nx-plugin

Vous pouvez également effectuer une simulation pour voir quels fichiers seraient modifiés

pnpm

pnpm nx g @aws/nx-plugin:ts#nx-plugin --dry-run

yarn

yarn nx g @aws/nx-plugin:ts#nx-plugin --dry-run

npm

npx nx g @aws/nx-plugin:ts#nx-plugin --dry-run

bun

bunx nx g @aws/nx-plugin:ts#nx-plugin --dry-run

Options

Paramètre	Type	Par défaut	Description
name Requis	string	-	TypeScript project name
directory	string	packages	Parent directory where the library is placed.
subDirectory	string	-	The sub directory the lib is placed in. By default this is the library name.

Résultat du générateur

Le générateur créera la structure de projet suivante :

• Répertoireyour-plugin/

  • Répertoiresrc/

    • index.ts Point d’entrée vide pour votre plugin
    • Répertoiremcp-server/

      • index.ts Exporte votre serveur
      • server.ts Configuration principale du serveur MCP
      • stdio.ts Point d’entrée pour le serveur MCP avec transport STDIO
      • http.ts Point d’entrée pour le serveur MCP avec transport HTTP streamable
      • Répertoiretools/

        • create-workspace-command.ts Outil pour guider la création d’espace de travail
        • general-guidance.ts Outil pour les bonnes pratiques Nx et plugin
        • list-generators.ts Outil pour lister les générateurs disponibles
        • generator-guide.ts Outil pour les informations détaillées sur les générateurs
      • utils.ts Fonctions utilitaires pour le serveur MCP
  • generators.json Configuration des générateurs Nx (vide initialement)
  • package.json Configuration du package du plugin avec binaire MCP server
  • tsconfig.json Configuration TypeScript (CommonJS pour compatibilité Nx)
  • project.json Configuration de projet Nx avec cibles de build et package

Utilisation de votre plugin Nx

Ajout de générateurs

Une fois votre projet de plugin créé, vous pouvez ajouter des générateurs avec ts#nx-generator :

VSCode

1. Installez le Nx Console VSCode Plugin si ce n'est pas déjà fait
2. Ouvrez la console Nx dans VSCode
3. Cliquez sur Generate (UI) dans la section "Common Nx Commands"
4. Recherchez @aws/nx-plugin - ts#nx-generator
5. Remplissez les paramètres requis
   • pluginProject: your-plugin
6. Cliquez sur Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin

yarn

yarn nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin

npm

npx nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin

bun

bunx nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin

Vous pouvez également effectuer une simulation pour voir quels fichiers seraient modifiés

pnpm

pnpm nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin --dry-run

yarn

yarn nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin --dry-run

npm

npx nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin --dry-run

bun

bunx nx g @aws/nx-plugin:ts#nx-generator --pluginProject=your-plugin --dry-run

Ceci ajoutera un nouveau générateur à votre plugin.

Astuce

Consultez le guide ts#nx-generator pour les détails d’implémentation des générateurs.

Assurez-vous de rédiger un README.md détaillé pour votre générateur, car il est utilisé par l’outil generator-guide du serveur MCP.

Cibles du projet

Le plugin généré inclut plusieurs cibles importantes :

Cible Build

Compile votre code TypeScript et prépare le plugin à l’utilisation :

pnpm

pnpm nx build your-plugin

yarn

yarn nx build your-plugin

npm

npx nx build your-plugin

bun

bunx nx build your-plugin

Cible Package

Crée un package distribuable prêt pour la publication sur NPM :

pnpm

pnpm nx package your-plugin

yarn

yarn nx package your-plugin

npm

npx nx package your-plugin

bun

bunx nx package your-plugin

Le package inclut toutes les ressources nécessaires :

• Fichiers JavaScript compilés
• Fichiers de déclaration TypeScript
• Fichiers de configuration des générateurs et exécuteurs
• Documentation et fichiers de licence

Intégration du serveur MCP

Le plugin configure un serveur MCP avec le générateur ts#mcp-server.

Outils

Le plugin inclut un serveur MCP complet fournissant aux assistants IA les outils suivants :

• general-guidance : Obtenir les bonnes pratiques pour utiliser Nx et votre plugin
• create-workspace-command : Apprendre à créer des espaces de travail compatibles avec votre plugin
• list-generators : Lister tous les générateurs disponibles dans votre plugin
• generator-guide : Obtenir des informations détaillées sur les générateurs (schémas et utilisation)

Configuration avec les assistants IA

Fichiers de configuration

La plupart des assistants IA compatibles avec MCP utilisent une approche de configuration similaire. Vous devrez créer ou mettre à jour un fichier de configuration avec les détails de votre serveur MCP :

{
  "mcpServers": {
    "your-mcp-server": {
      "command": "npx",
      "args": ["tsx", "/path/to/your-mcp-server/stdio.ts"]
    }
  }
}

Attention

Si vous recevez une erreur comme ENOENT npx lors de la connexion à votre serveur, vous devrez peut-être spécifier le chemin complet vers npx, que vous pouvez obtenir en exécutant which npx dans votre terminal.

Rechargement à chaud

Pendant le développement de votre serveur MCP, vous pouvez activer le flag --watch pour que l’assistant IA détecte toujours les dernières versions des outils/ressources :

{
  "mcpServers": {
    "your-mcp-server": {
      "command": "npx",
      "args": ["tsx", "--watch", "/path/to/your-mcp-server/stdio.ts"]
    }
  }
}

Note

Si vous ajoutez de nouveaux outils ou ressources, vous devrez peut-être rafraîchir votre serveur MCP dans l’assistant IA.

Configuration spécifique à l’assistant

Consultez la documentation suivante pour configurer MCP avec des assistants IA spécifiques :

• Amazon Q Developer
• Cline
• Cursor
• Claude Code
• Roo Code

Astuce

Certains assistants IA comme Amazon Q Developer permettent de spécifier une configuration MCP au niveau de l’espace de travail, ce qui est particulièrement utile pour définir les serveurs MCP pertinents pour un projet donné.

Personnalisation du serveur MCP

Vous pouvez étendre le serveur MCP en modifiant server.ts pour ajouter des outils ou ressources spécifiques à votre domaine.

Pour plus de détails sur l’écriture de serveurs MCP, consultez le guide ts#mcp-server.

Publication de votre plugin

Préparation à la publication

1. Mettre à jour les informations du package : Modifiez le package.json avec le nom, la version, la description et les informations de dépôt appropriées.

2. Compiler le package :

   pnpm

   pnpm nx package your-plugin

   yarn

   yarn nx package your-plugin

   npm

   npx nx package your-plugin

   bun

   bunx nx package your-plugin

3. Tester localement : Vous pouvez tester votre plugin localement en l’installant dans un autre espace de travail :

   npm install /path/to/your/workspace/dist/your-plugin/package

Publication sur NPM

Une fois votre plugin prêt :

cd dist/your-plugin/package
npm publish

Utilisation des plugins publiés

Après publication, les autres utilisateurs peuvent installer et utiliser votre plugin :

pnpm

pnpm add -w your-plugin-name

yarn

yarn add your-plugin-name

npm

npm install --legacy-peer-deps your-plugin-name

bun

bun install your-plugin-name

Puis utilisez vos générateurs :

VSCode

1. Installez le Nx Console VSCode Plugin si ce n'est pas déjà fait
2. Ouvrez la console Nx dans VSCode
3. Cliquez sur Generate (UI) dans la section "Common Nx Commands"
4. Recherchez your-plugin-name - your-generator-name
5. Remplissez les paramètres requis
6. Cliquez sur Generate

CLI

pnpm

pnpm nx g your-plugin-name:your-generator-name

yarn

yarn nx g your-plugin-name:your-generator-name

npm

npx nx g your-plugin-name:your-generator-name

bun

bunx nx g your-plugin-name:your-generator-name

Vous pouvez également effectuer une simulation pour voir quels fichiers seraient modifiés

pnpm

pnpm nx g your-plugin-name:your-generator-name --dry-run

yarn

yarn nx g your-plugin-name:your-generator-name --dry-run

npm

npx nx g your-plugin-name:your-generator-name --dry-run

bun

bunx nx g your-plugin-name:your-generator-name --dry-run

Configuration des assistants IA avec votre plugin publié

Le serveur MCP de votre plugin publié peut être configuré ainsi :

{
  "mcpServers": {
    "aws-nx-mcp": {
      "command": "npx",
      "args": ["-y", "-p", "your-plugin-name", "your-plugin-name-mcp-server"]
    }
  }
}