wopee-mcp 1.11.1 → 1.13.0

package/README.md

@@ -70,6 +70,59 @@ If you're unsure about your proxy settings, check your VS Code settings (`settin
 - `http://10.x.x.x:8080`
 - `http://username:password@proxy.company.com:8080` (if authentication is required)
 
+### TLS / Certificate Issues
+
+**This is not required for MCP to work.** If you see HTTPS or certificate-related errors, that indicates a TLS or certificate trust issue in your environment.
+
+If the server fails with errors such as **`UNABLE_TO_VERIFY_LEAF_SIGNATURE`** or **`certificate has expired`**, it may be due to:
+
+- **Self-signed certificates** (e.g. when `WOPEE_API_URL` points to an internal or dev server)
+- **Corporate proxy / SSL inspection** (traffic re-encrypted with a corporate CA your machine doesn’t trust)
+- **Missing CA certificates** in Node’s trust store
+
+#### Preferred solutions (secure)
+
+1. **Use a valid TLS certificate** – e.g. Let’s Encrypt, or an internal CA – and ensure the **full certificate chain** is served.
+2. **Install the corporate or internal CA** so Node trusts it:
+
+   Example:
+
+   ```bash
+   export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/internal-ca.pem
+   ```
+
+   In MCP config `env`:
+
+   ```json
+   "env": {
+     "WOPEE_PROJECT_UUID": "your-project-uuid-here",
+     "WOPEE_API_KEY": "your-api-key-here",
+     "NODE_EXTRA_CA_CERTS": "/path/to/ca.pem"
+   }
+   ```
+
+#### Insecure workaround (not recommended)
+
+For **local debugging only**, you may disable TLS verification in Node. This should **never** be used in production, as it disables HTTPS security and exposes traffic to interception.
+
+```bash
+export NODE_TLS_REJECT_UNAUTHORIZED=0
+```
+
+Or in MCP config `env`:
+
+```json
+"env": {
+  "WOPEE_PROJECT_UUID": "your-project-uuid-here",
+  "WOPEE_API_KEY": "your-api-key-here",
+  "NODE_TLS_REJECT_UNAUTHORIZED": "0"
+}
+```
+
+Treat this as a **debug-only escape hatch**, not a normal setup step.
+
+**Note:** Some users have reported setting `PYTHONHTTPSVERIFY=0` as well. This MCP server does not use Python; that variable has no effect on it. It would only apply if you run a Python-based MCP host or other tooling that also performs HTTPS in the same environment—outside the scope of this server.
+
 ## Getting Started
 
 Most tools in this MCP server require a `suiteUuid` to operate. You have two options to get started:
@@ -86,13 +139,21 @@ This will return a list of all analysis suites with their UUIDs, which you can t
 
 ### Option 2: Create a New Suite
 
-If you don't have any suites yet, create a fresh analysis suite:
+If you don't have any suites yet, you have two options:
+
+**Automatic Analysis:** Create and dispatch a full analysis/crawling suite:
 
 ```
 Use the wopee_dispatch_analysis tool to create and dispatch a new analysis/crawling suite.
 ```
 
-This will create a new suite and return its UUID, which you can use for subsequent operations.
+**Blank Suite:** Create an empty suite for manual configuration:
+
+```
+Use the wopee_create_blank_suite tool to create a blank analysis suite.
+```
+
+Both options will return a suite UUID, which you can use for subsequent operations.
 
 ## Available Tools
 
@@ -122,6 +183,18 @@ Creates and dispatches a new analysis/crawling suite for your project. Use this
 Dispatch a new analysis suite
 ```
 
+#### `wopee_create_blank_suite`
+
+Creates a blank analysis suite for your project. Use this when you want to manually configure and populate a suite rather than having it automatically analyzed.
+
+- **Returns:** The created suite information including its UUID
+
+**Example Usage:**
+
+```
+Create a blank analysis suite for my project
+```
+
 ### Generation Tools
 
 These tools generate various artifacts for a specific suite. All require a `suiteUuid` and `type` to generate.

package/build/tools/index.js

@@ -3,8 +3,10 @@ import { wopeeUpdateArtifact } from "./wopee_update_artifact/index.js";
 import { wopeeGenerateArtifact } from "./wopee_generate_artifact/index.js";
 import { wopeeDispatchAgent } from "./wopee_dispatch_agent/index.js";
 import { wopeeDispatchAnalysis } from "./wopee_dispatch_analysis/index.js";
+import { wopeeCreateBlankSuite } from "./wopee_create_blank_suite/index.js";
 import { wopeeFetchAnalysisSuites } from "./wopee_fetch_analysis_suites/index.js";
 export const TOOLS = [
+    wopeeCreateBlankSuite,
     wopeeFetchAnalysisSuites,
     wopeeDispatchAnalysis,
     wopeeDispatchAgent,

package/build/tools/shared/gql-queries.js

@@ -155,3 +155,41 @@ export const GenerateReusableTestCaseSteps = `
     generateReusableTestCaseSteps(input: $input)
   }
 `;
+export const CreateBlankAnalysisSuite = `
+  mutation CreateBlankAnalysisSuite($projectUuid: ID!) {
+    createBlankAnalysisSuite(projectUuid: $projectUuid) {
+      uuid
+      name
+      suiteType
+      executionStatus
+      createdAt
+      updatedAt
+      analysisIdentifier
+      suiteRunningStatus
+      generatedAnalysisDataState {
+        suiteUuid
+        appContext {
+          isGenerated
+          status
+        }
+        generalUserStories {
+          isGenerated
+          status
+        }
+        userStories {
+          isGenerated
+          status
+        }
+        testCases {
+          isGenerated
+          status
+        }
+        reusableTestCases {
+          isGenerated
+          status
+        }
+        testCaseSteps
+      }
+    }
+  }
+`;

package/build/tools/shared/types.js

@@ -1,5 +1,6 @@
 export var ToolName;
 (function (ToolName) {
+    ToolName["WOPEE_CREATE_BLANK_SUITE"] = "wopee_create_blank_suite";
     ToolName["WOPEE_FETCH_ANALYSIS_SUITES"] = "wopee_fetch_analysis_suites";
     ToolName["WOPEE_DISPATCH_ANALYSIS"] = "wopee_dispatch_analysis";
     ToolName["WOPEE_DISPATCH_AGENT"] = "wopee_dispatch_agent";

package/build/tools/wopee_create_blank_suite/index.js

@@ -0,0 +1,43 @@
+import { getConfig } from "../../utils/getConfig.js";
+import { requestClient } from "../../utils/requestClient.js";
+import { ToolName } from "../shared/types.js";
+import { CreateBlankAnalysisSuite } from "../shared/gql-queries.js";
+export const wopeeCreateBlankSuite = {
+    name: ToolName.WOPEE_CREATE_BLANK_SUITE,
+    config: {
+        title: "Create blank analysis suite",
+        description: "Create a blank analysis suite for a project",
+    },
+    handler: async () => {
+        const { WOPEE_PROJECT_UUID } = getConfig();
+        if (!WOPEE_PROJECT_UUID)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "WOPEE_PROJECT_UUID is not set",
+                    },
+                ],
+            };
+        const result = await requestClient(CreateBlankAnalysisSuite, {
+            projectUuid: WOPEE_PROJECT_UUID,
+        });
+        if (!result || !result.createBlankAnalysisSuite)
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Failed to fetch analysis suites",
+                    },
+                ],
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result.createBlankAnalysisSuite, null, 2),
+                },
+            ],
+        };
+    },
+};

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "wopee-mcp": "./build/index.js"
   },
-  "version": "1.11.1",
+  "version": "1.13.0",
   "description": "Wopee.io MCP server",
   "main": "./build/index.js",
   "scripts": {