impact-ui-mcp-server 1.0.1 → 1.0.2

package/NPM_PACKAGE_SETUP.md

@@ -28,6 +28,10 @@ your-project/
 npm install impact-ui impact-ui-mcp-server
 ```
 
+**Package Names:**
+- `impact-ui` - The UI library
+- `impact-ui-mcp-server` - The MCP server (published to npm)
+
 ## Windsurf Configuration
 
 Since Windsurf needs absolute paths, use this configuration:

package/generate-cursor-config.js

@@ -29,56 +29,78 @@ let config;
 let impactUiPathToUse = impactUiPath;
 
 if (useNpm) {
-  // Check if package is installed
-  let packagePath;
+  // Check if package is installed (try both scoped and unscoped names)
+  let packageFound = false;
+  let packageName = "impact-ui-mcp-server";
+  
   try {
-    packagePath = execSync("npm list @impact-analytics/impact-ui-mcp-server --json", { encoding: "utf-8", stdio: "pipe" });
+    const packagePath = execSync("npm list impact-ui-mcp-server --json", { encoding: "utf-8", stdio: "pipe" });
     const packageInfo = JSON.parse(packagePath);
-    if (!packageInfo.dependencies || !packageInfo.dependencies["@impact-analytics/impact-ui-mcp-server"]) {
-      console.log("\n⚠️  Package not found. Install it first:");
-      console.log("   npm install @impact-analytics/impact-ui-mcp-server\n");
-      process.exit(1);
+    if (packageInfo.dependencies && packageInfo.dependencies["impact-ui-mcp-server"]) {
+      packageFound = true;
     }
   } catch (error) {
-    console.log("\n⚠️  Package not found. Install it first:");
-    console.log("   npm install @impact-analytics/impact-ui-mcp-server\n");
-    process.exit(1);
-  }
-
-  // Get the absolute path to Impact UI
-  if (!impactUiPathToUse) {
-    console.log("\n❓ Please provide the path to your Impact UI repository:");
-    console.log("   node generate-cursor-config.js --npm --impact-ui-path=/path/to/impact-ui\n");
-    process.exit(1);
+    // Try scoped version
+    try {
+      const packagePath = execSync("npm list @impact-analytics/impact-ui-mcp-server --json", { encoding: "utf-8", stdio: "pipe" });
+      const packageInfo = JSON.parse(packagePath);
+      if (packageInfo.dependencies && packageInfo.dependencies["@impact-analytics/impact-ui-mcp-server"]) {
+        packageFound = true;
+        packageName = "@impact-analytics/impact-ui-mcp-server";
+      }
+    } catch (error2) {
+      // Package not found, but continue - user might install it later
+    }
   }
 
-  // Verify the path exists
-  if (!existsSync(impactUiPathToUse)) {
-    console.log(`\n❌ Path does not exist: ${impactUiPathToUse}\n`);
-    process.exit(1);
+  // For npm packages, use ${workspaceFolder} variables (Cursor supports these)
+  // Try to detect actual structure, otherwise use most common structure
+  const cwd = process.cwd();
+  let mcpServerPath = "${workspaceFolder}/frontend/node_modules/impact-ui-mcp-server/src/index.js";
+  let impactUiPath = "${workspaceFolder}/frontend/node_modules/impact-ui";
+  
+  // Check actual structure to determine which path to use
+  const frontendMcpPath = resolve(cwd, "frontend", "node_modules", "impact-ui-mcp-server", "src", "index.js");
+  const rootMcpPath = resolve(cwd, "node_modules", "impact-ui-mcp-server", "src", "index.js");
+  
+  if (existsSync(frontendMcpPath)) {
+    // Packages are in frontend/node_modules
+    mcpServerPath = "${workspaceFolder}/frontend/node_modules/impact-ui-mcp-server/src/index.js";
+    impactUiPath = "${workspaceFolder}/frontend/node_modules/impact-ui";
+  } else if (existsSync(rootMcpPath)) {
+    // Packages are in root node_modules
+    mcpServerPath = "${workspaceFolder}/node_modules/impact-ui-mcp-server/src/index.js";
+    impactUiPath = "${workspaceFolder}/node_modules/impact-ui";
   }
-
-  if (!existsSync(resolve(impactUiPathToUse, "frontend"))) {
-    console.log(`\n❌ Frontend directory not found at: ${resolve(impactUiPathToUse, "frontend")}\n`);
-    process.exit(1);
+  
+  // Check for scoped package name
+  const frontendScopedMcpPath = resolve(cwd, "frontend", "node_modules", "@impact-analytics", "impact-ui-mcp-server", "src", "index.js");
+  const rootScopedMcpPath = resolve(cwd, "node_modules", "@impact-analytics", "impact-ui-mcp-server", "src", "index.js");
+  
+  if (existsSync(frontendScopedMcpPath)) {
+    mcpServerPath = "${workspaceFolder}/frontend/node_modules/@impact-analytics/impact-ui-mcp-server/src/index.js";
+  } else if (existsSync(rootScopedMcpPath)) {
+    mcpServerPath = "${workspaceFolder}/node_modules/@impact-analytics/impact-ui-mcp-server/src/index.js";
   }
 
   config = {
     "mcp.servers": {
       "impact-ui": {
         "command": "node",
-        "args": [
-          "./node_modules/@impact-analytics/impact-ui-mcp-server/src/index.js"
-        ],
+        "args": [mcpServerPath],
         "cwd": "${workspaceFolder}",
         "env": {
-          "IMPACT_UI_PATH": impactUiPathToUse
+          "IMPACT_UI_NODE_MODULES": impactUiPath
         }
       }
     }
   };
 
-  console.log("\n📦 NPM Package Configuration\n");
+  console.log("\n📦 NPM Package Configuration (with ${workspaceFolder} variables)\n");
+  if (!packageFound) {
+    console.log("⚠️  Note: Package not detected in current directory.");
+    console.log("   Make sure to install: npm install impact-ui-mcp-server\n");
+  }
 } else {
   // Local development configuration
   const mcpServerPath = resolve(__dirname);
@@ -109,5 +131,6 @@ console.log("🔄 Restart Cursor IDE after adding the configuration\n");
 
 if (useNpm) {
   console.log("📝 Note: Make sure to install the package first:");
-  console.log("   npm install @impact-analytics/impact-ui-mcp-server\n");
+  console.log("   npm install impact-ui-mcp-server\n");
+  console.log("💡 The configuration uses ${workspaceFolder} variables which Cursor resolves automatically.\n");
 }

package/generate-windsurf-config.js

@@ -56,20 +56,43 @@ if (useNpm) {
     process.exit(1);
   }
 
+  // For npm packages, detect structure and use appropriate paths
+  const cwd = process.cwd();
+  let mcpServerPath = "./node_modules/impact-ui-mcp-server/src/index.js";
+  let impactUiNodeModules = null;
+  
+  // Check actual structure
+  const frontendMcpPath = resolve(cwd, "frontend", "node_modules", "impact-ui-mcp-server", "src", "index.js");
+  const rootMcpPath = resolve(cwd, "node_modules", "impact-ui-mcp-server", "src", "index.js");
+  
+  if (existsSync(frontendMcpPath)) {
+    mcpServerPath = "./frontend/node_modules/impact-ui-mcp-server/src/index.js";
+    impactUiNodeModules = "./frontend/node_modules/impact-ui";
+  } else if (existsSync(rootMcpPath)) {
+    mcpServerPath = "./node_modules/impact-ui-mcp-server/src/index.js";
+    impactUiNodeModules = "./node_modules/impact-ui";
+  }
+
   config = {
     "mcpServers": {
       "impact-ui": {
         "command": "node",
-        "args": [
-          "./node_modules/impact-ui-mcp-server/src/index.js"
-        ],
-        "cwd": "${workspaceFolder}",
-        "env": {
-          "IMPACT_UI_PATH": impactUiPathToUse
-        }
+        "args": [mcpServerPath],
+        "cwd": "${workspaceFolder}"
       }
     }
   };
+  
+  // Add environment variable if impact-ui is in node_modules
+  if (impactUiNodeModules) {
+    config.mcpServers["impact-ui"].env = {
+      "IMPACT_UI_NODE_MODULES": impactUiNodeModules
+    };
+  } else if (impactUiPathToUse) {
+    config.mcpServers["impact-ui"].env = {
+      "IMPACT_UI_PATH": impactUiPathToUse
+    };
+  }
 
   console.log("\n📦 NPM Package Configuration\n");
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impact-ui-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP Server for Impact UI Library - Provides AI access to component documentation and code examples",
   "type": "module",
   "main": "src/index.js",