pictmcp 0.2.0 → 0.3.0

package/README.md

@@ -1,7 +1,5 @@
 # PictMCP
 
-Pairwise Independent Combinatorial Testings for MCP
-
 ## 🚧 Work in Progress 🚧
 
 > [!WARNING]
@@ -10,32 +8,27 @@ Pairwise Independent Combinatorial Testings for MCP
 >
 > Use in production environments is **not recommended** at this time.
 
+## Project overview
+
+PictMCP is an MCP (Model Context Protocol) server that provides pairwise combinatorial testing capabilities to AI assistants. It wraps the PICT (Pairwise Independent Combinatorial Testing) algorithm via WebAssembly, enabling AI clients to generate optimized test case combinations.
+
 ## Install
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org/) (v22 or higher)
+- [Node.js](https://nodejs.org/) (v24 or higher)
 - [pnpm](https://pnpm.io/) (v10 or higher)
 
 ### Commands
 
-In your terminal
-
-```sh
-git clone https://github.com/takeyaqa/PictMCP.git
-cd PictMCP
-pnpm install
-pnpm build
-```
-
 In your MCP client
 
 ```json
 {
   "mcpServers": {
     "PictMCP": {
-      "command": "node",
-      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/PictMCP/dist/index.js"]
+      "command": "pnpx",
+      "args": ["pictmcp"]
     }
   }
 }

package/dist/index.d.ts

@@ -1,3 +1 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-declare const server: McpServer;
-export { server };
+export {};

package/dist/index.js

@@ -1,50 +1,15 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { PictRunner } from "@takeyaqa/pict-wasm";
-// Create server instance
-const server = new McpServer({
-    name: "PictMCP",
-    version: "0.2.0",
-});
-// Register pict tools
-server.registerTool("generate-test-cases", {
-    description: "Generates test cases using pairwise combination algorithm",
-    inputSchema: {
-        parameters: z
-            .object({ name: z.string(), values: z.string() })
-            .array()
-            .describe("Parameters for the test case generation"),
-        constraints: z
-            .string()
-            .optional()
-            .describe("Constraints for the test case generation"),
-    },
-}, async ({ parameters, constraints }) => {
-    const pictRunner = new PictRunner();
-    await pictRunner.init();
-    const output = pictRunner.run(parameters, { constraintsText: constraints });
-    const formattedOutput = output.body.map((row) => row.map((cell) => cell.trim()).join(", "));
-    const formattedHeader = output.header.map((cell) => cell.trim()).join(", ");
-    const formattedBody = formattedOutput.join("\n");
-    const formattedOutputText = `Header: ${formattedHeader}\nBody:\n${formattedBody}`;
-    return {
-        content: [
-            {
-                type: "text",
-                text: formattedOutputText,
-            },
-        ],
-    };
-});
-// export for testing purposes
-export { server };
+import { PictMcpServer } from "./server.js";
 async function main() {
+    const server = new PictMcpServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("PictMCP Server running on stdio");
 }
-main().catch((error) => {
+try {
+    await main();
+}
+catch (error) {
     console.error("Fatal error in main():", error);
     process.exit(1);
-});
+}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare class PictMcpServer extends McpServer {
+    constructor();
+}

package/dist/server.js

@@ -0,0 +1,86 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { PictRunner } from "@takeyaqa/pict-wasm";
+export class PictMcpServer extends McpServer {
+    constructor() {
+        super({
+            name: "io.github.takeyaqa/PictMCP",
+            title: "PictMCP",
+            version: "0.3.0",
+            description: "Provides pairwise combinatorial testing capabilities to AI assistants.",
+            websiteUrl: "https://github.com/takeyaqa/PictMCP#readme",
+            icons: [
+                {
+                    src: "https://raw.githubusercontent.com/takeyaqa/PictMCP/main/assets/PictMCP_icon@64x64.png",
+                    mimeType: "image/png",
+                    sizes: ["64x64"],
+                },
+                {
+                    src: "https://raw.githubusercontent.com/takeyaqa/PictMCP/main/assets/PictMCP_icon.svg",
+                    mimeType: "image/svg+xml",
+                    sizes: ["any"],
+                },
+            ],
+        });
+        // Register pict tools
+        this.registerTool("generate-test-cases", {
+            title: "Generate test cases",
+            description: "Executes PICT with the given parameters and options to generate test cases.",
+            inputSchema: {
+                parameters: z
+                    .object({
+                    name: z.string().describe("The name of the parameter."),
+                    values: z
+                        .string()
+                        .describe("A comma-separated string of possible values for this parameter."),
+                })
+                    .array()
+                    .describe("Represents a parameter definition for PICT test case generation."),
+                constraintsText: z
+                    .string()
+                    .optional()
+                    .describe("PICT constraint expressions to filter invalid combinations."),
+            },
+            outputSchema: {
+                result: z
+                    .object({
+                    header: z
+                        .string()
+                        .array()
+                        .describe("An array of parameter names representing the column headers."),
+                    body: z
+                        .string()
+                        .array()
+                        .array()
+                        .describe("A two-dimensional array where each inner array represents a test case, with values corresponding to the header columns."),
+                })
+                    .describe("Represents the parsed result of PICT test case generation."),
+                modelFile: z
+                    .string()
+                    .describe("The complete model file content that was passed to PICT."),
+                message: z
+                    .string()
+                    .optional()
+                    .describe("Optional message output from PICT, typically containing information."),
+            },
+        }, async ({ parameters, constraintsText }) => {
+            const pictRunner = await PictRunner.create();
+            const output = pictRunner.run(parameters, {
+                constraintsText,
+            });
+            return {
+                structuredContent: {
+                    result: output.result,
+                    modelFile: output.modelFile,
+                    message: output.message,
+                },
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(output),
+                    },
+                ],
+            };
+        });
+    }
+}

package/package.json

@@ -1,9 +1,20 @@
 {
   "name": "pictmcp",
   "mcpName": "io.github.takeyaqa/PictMCP",
-  "version": "0.2.0",
-  "description": "Pairwise Testing for the AI",
-  "keywords": [],
+  "version": "0.3.0",
+  "description": "MCP (Model Context Protocol) server that provides pairwise combinatorial testing capabilities to AI assistants.",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "ai",
+    "pict",
+    "testing",
+    "testing-tools",
+    "test-case-generation",
+    "combinatorial-testing",
+    "pairwise",
+    "pairwise-testing"
+  ],
   "homepage": "https://github.com/takeyaqa/PictMCP#readme",
   "bugs": {
     "url": "https://github.com/takeyaqa/PictMCP/issues"
@@ -23,21 +34,25 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "@takeyaqa/pict-wasm": "3.7.4-wasm.11",
+    "@takeyaqa/pict-wasm": "3.7.4-wasm.12",
     "zod": "^4.3.5"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
+    "@tsconfig/node-ts": "^23.6.2",
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^25.0.9",
+    "@vitest/eslint-plugin": "^1.6.6",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^17.0.0",
     "prettier": "^3.8.0",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.53.0",
+    "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.17"
   },
+  "engines": {
+    "node": ">=24"
+  },
   "devEngines": {
     "runtime": {
       "name": "node",
@@ -53,10 +68,12 @@
   "scripts": {
     "build": "tsc && chmod 755 dist/index.js",
     "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
+    "fmt": "prettier --write .",
+    "fmt:check": "prettier --check .",
     "lint": "eslint .",
-    "format": "prettier --check .",
+    "lint:fix": "eslint --fix .",
+    "typecheck": "tsc --project tsconfig.typecheck.json",
     "test": "vitest",
-    "test:no-watch": "vitest run"
+    "test:run": "vitest run"
   }
 }

package/dist/index.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/index.spec.js

@@ -1,25 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
-import packageJson from "../package.json" with { type: "json" };
-import serverJson from "../server.json" with { type: "json" };
-import { server } from "./index.js";
-describe("PictMCP Server", () => {
-    let client;
-    beforeEach(async () => {
-        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
-        client = new Client({ name: "test-client", version: "1.0.0" });
-        await server.connect(serverTransport);
-        await client.connect(clientTransport);
-    });
-    afterEach(async () => {
-        await client.close();
-        await server.close();
-    });
-    it("should return version matching package configuration", async () => {
-        const serverVersion = client.getServerVersion();
-        expect(serverVersion?.version).toBe(packageJson.version);
-        expect(serverVersion?.version).toBe(serverJson.version);
-        expect(serverVersion?.version).toBe(serverJson.packages[0].version);
-    });
-});