Merge branch 'master' into release

Author: MaxKless

CONTRIBUTING.md

@@ -18,21 +18,25 @@ We are trying to keep GitHub issues for bug reports and feature requests. Stack
 
 Alternatively, if you are using IntelliJ IDEA to develop Nx Console, it can take care of the java installation for you.
 
-## Running the Extension locally
+## Development
 
-### VSCode
+### Running the Extension locally
+
+#### VSCode
 
 In order to start Nx Console in development mode, the repo needs to be built. Running `yarn watch` via the terminal or using the command prompt to execute `Tasks: Run Task -> Build and watch Nx Console` will automatically generate build artifacts whenever the code changes. </br>
 Use the `F5` key or the debug menu option `Launch Client + Server` to start the Extension Development Host.
 
 > :warning: Even though builds will be generated automatically, the Extension Development Host needs to be restarted in order to apply a new set of changes.
 
-### IntelliJ
+#### IntelliJ
 
 The `runIde` gradle task takes care of building Nx Console and starting a development instance of IntelliJ. Run the `nx-console [runIde]` gradle config in your IDE or use `nx run intellij:runIde` (which executes `./gradlew :apps:intellij:runIde` under the hood).
 
 When debugging the JCEF-based generate UI, you can attach an instance of Chrome Devtools to the browser. To enable this, make sure to [set the corresponding registry key](https://plugins.jetbrains.com/docs/intellij/jcef.html#debugging).
 
+### Building the extension for local testing
+
 ## Submitting a PR
 
 Please follow the following guidelines:

README.md

@@ -56,7 +56,7 @@ Nx Console enhances your editors AI features by providing relevant context to th
 
 In VSCode, access the enhancements via the `@nx` chat participant. Learn more [in our blog post](https://nx.dev/blog/nx-just-made-your-llm-smarter) or the [Nx docs](https://nx.dev/features/enhance-AI#vs-code-with-github-copilot)
 
-In Cursor or anywhere else, use the Nx MCP server. Learn more [in our Cursor blog](https://nx.dev/blog/nx-made-cursor-smarter) post or [the Nx docs](https://nx.dev/features/enhance-AI#cursor)
+In Cursor or anywhere else, use the [Nx MCP server](./apps/nx-mcp/README.md). Learn more [in our Cursor blog](https://nx.dev/blog/nx-made-cursor-smarter) post or [the Nx docs](https://nx.dev/features/enhance-AI#cursor)
 
 ### Project Details View
 

apps/generate-ui-v2/src/main.ts

@@ -13,24 +13,22 @@ export class Root extends LitElement {
   icc: IdeCommunicationController;
 
   private formValuesService: FormValuesService;
+  @state()
+  private searchValue = '';
+  private rootStyles = css`
+    --border-width: 1;
+  `;
 
   constructor() {
     super();
     this.icc = new IdeCommunicationController(this);
     this.formValuesService = new FormValuesService(this);
 
     window.addEventListener('keydown', (e) =>
-      this.handleGlobalKeyboardShortcuts(e)
+      this.handleGlobalKeyboardShortcuts(e),
     );
   }
 
-  @state()
-  private searchValue = '';
-
-  private rootStyles = css`
-    --border-width: 1;
-  `;
-
   render() {
     const options = this.icc.generatorSchema?.options;
     return html` <div
@@ -55,6 +53,20 @@ export class Root extends LitElement {
     </div>`;
   }
 
+  openNxDev(link: string) {
+    const a = document.createElement('a');
+    a.href = link;
+    a.target = '_blank'; // Optional: Open in new tab
+    a.style.display = 'none';
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+  }
+
+  protected createRenderRoot() {
+    return this;
+  }
+
   private renderHeader() {
     const isNxGenerator =
       this.icc.generatorSchema?.collectionName?.includes('@nx') ||
@@ -90,17 +102,16 @@ export class Root extends LitElement {
           <div class="flex shrink-0">
             ${when(
               isNxGenerator && this.icc.editor === 'vscode',
-              () =>
-                html`
-                  <button-element
-                    @click="${() => this.openNxDev(nxDevLink)}"
-                    title="Open generator documentation on nx.dev"
-                    appearance="icon"
-                    text="link-external"
-                    class="self-center py-2 pl-3"
-                  >
-                  </button-element>
-                `
+              () => html`
+                <button-element
+                  @click="${() => this.openNxDev(nxDevLink)}"
+                  title="Open generator documentation on nx.dev"
+                  appearance="icon"
+                  text="link-external"
+                  class="self-center py-2 pl-3"
+                >
+                </button-element>
+              `,
             )}
             <button-element
               class="self-center py-2 pl-3"
@@ -113,22 +124,23 @@ export class Root extends LitElement {
             </button-element>
             ${when(
               !this.icc.configuration?.enableTaskExecutionDryRunOnChange,
-              () =>
-                html`<button-element
-                    class="self-center py-2 pl-3 sm:hidden"
-                    @click="${() => this.formValuesService.runGenerator(true)}"
-                    text="debug"
-                    appearance="icon"
-                    title="Dry Run"
-                  >
-                  </button-element>
-                  <button-element
-                    class="hidden py-2 pl-3 sm:block"
-                    @click="${() => this.formValuesService.runGenerator(true)}"
-                    text="Dry Run"
-                    appearance="secondary"
-                  >
-                  </button-element> `
+              () => html`
+                <button-element
+                  class="self-center py-2 pl-3 sm:hidden"
+                  @click="${() => this.formValuesService.runGenerator(true)}"
+                  text="debug"
+                  appearance="icon"
+                  title="Dry Run"
+                >
+                </button-element>
+                <button-element
+                  class="hidden py-2 pl-3 sm:block"
+                  @click="${() => this.formValuesService.runGenerator(true)}"
+                  text="Dry Run"
+                  appearance="secondary"
+                >
+                </button-element>
+              `,
             )}
 
             <button-element
@@ -146,7 +158,7 @@ export class Root extends LitElement {
             html` <banner-element
               message="${this.icc.banner?.message}"
               type="${this.icc.banner?.type}"
-            ></banner-element>`
+            ></banner-element>`,
         )}
         <div class="mt-5">
           <search-bar
@@ -187,18 +199,4 @@ export class Root extends LitElement {
       }
     }
   }
-
-  openNxDev(link: string) {
-    const a = document.createElement('a');
-    a.href = link;
-    a.target = '_blank'; // Optional: Open in new tab
-    a.style.display = 'none';
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-  }
-
-  protected createRenderRoot() {
-    return this;
-  }
 }

apps/nx-mcp/README.md

@@ -6,9 +6,15 @@ A [Model Context Protocol](https://modelcontextprotocol.io/introduction) server
 
 ## Overview
 
-The Nx MCP Server provides structured context about your Nx workspace to AI assistant models, enabling them to better understand and interact with your Nx projects. It serves as a bridge between AI models and your Nx workspace and documentation.
+The Nx MCP server gives LLMs deep access to your monorepo’s structure: project relationships, file mappings, runnable tasks, ownership info, tech stacks, Nx generators, and even Nx documentation. With this context, LLMs can generate code tailored to your stack, understand the impact of a change, and apply modifications across connected files with precision. This is possible because Nx already understands the higher-level architecture of your workspace, and monorepos bring all relevant projects into one place.
 
-## Installation
+Read more in [our blog post](https://nx.dev/blog/nx-made-cursor-smarter) and [in our docs](https://nx.dev/features/enhance-AI).
+
+## Installation and Usage
+
+There are two ways to use this MCP server:
+
+### a) Run it via the nx-mcp package
 
 Simply invoke the MCP server via `npx` or your package manager's equivalent.
 
@@ -22,6 +28,15 @@ If you want to host the server instead of communicating via `stdio`, you can use
 
 Run `nx-mcp --help` to see what options are available.
 
+### b) Use the Nx Console extension
+
+If you're using Cursor you can directly install the Nx Console extension which automatically manages the MCP server for you.
+
+More info:
+
+- [Install Nx Console](https://nx.dev/getting-started/editor-setup)
+- [Configure Cursor to use the nx-mcp](https://nx.dev/features/enhance-AI#cursor)
+
 ## Available Tools
 
 Currently, the Nx MCP server provides a set of tools. Resources, Roots and Prompts aren't supported yet.
@@ -31,6 +46,9 @@ Currently, the Nx MCP server provides a set of tools. Resources, Roots and Promp
 - **nx_docs**: Retrieves documentation sections relevant to user queries
 - **nx_generators**: Returns a list of available generators in the workspace
 - **nx_generator_schema**: Provides detailed schema information for a specific generator
+- **nx_available_plugins**: Returns a list of available Nx plugins from the npm registry with their descriptions
+
+When no workspace path is specified, only the `nx_docs` and `nx_available_plugins` tools will be available.
 
 ## Contributing & Development
 

apps/nx-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-mcp",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "main": "main.js",
   "description": "A Model Context Protocol server implementation for Nx",
   "author": {