vendure-mcp-graphql 1.1.1 → 1.3.0

package/README.md

@@ -1,5 +1,7 @@
 # vendure-mcp-graphql
 
+[![npm version](https://img.shields.io/npm/v/vendure-mcp-graphql.svg)](https://www.npmjs.com/package/vendure-mcp-graphql) [![npm downloads](https://img.shields.io/npm/dm/vendure-mcp-graphql.svg)](https://www.npmjs.com/package/vendure-mcp-graphql)
+
 MCP (Model Context Protocol) server for interacting with Vendure GraphQL APIs (Admin & Shop).
 
 ## Installation
@@ -20,7 +22,7 @@ Configure as an MCP server in your IDE (like Claude Desktop):
       "args": [],
       "env": {
         "VENDURE_URL": "http://localhost:3000/admin-api",
-        "VENDURE_AUTH_TOKEN": "your-token-here"
+        "VENDURE_API_KEY": "your-key-here"
       }
     }
   }
@@ -30,28 +32,31 @@ Configure as an MCP server in your IDE (like Claude Desktop):
 ## Tools
 
 ### Admin API
-| Tool | Description |
-|------|-------------|
-| `admin_query` | Execute a GraphQL query on the Admin API |
-| `admin_mutation` | Execute a GraphQL mutation on the Admin API |
-| `admin_batch_mutation` | Execute a mutation in bulk for multiple IDs (concurrent) |
-| `get_admin_schema` | Fetch the full Admin API schema introspection |
-| `list_admin_operations` | List all available Admin API queries and mutations |
+
+| Tool                    | Description                                              |
+| ----------------------- | -------------------------------------------------------- |
+| `admin_query`           | Execute a GraphQL query on the Admin API                 |
+| `admin_mutation`        | Execute a GraphQL mutation on the Admin API              |
+| `admin_batch_mutation`  | Execute a mutation in bulk for multiple IDs (concurrent) |
+| `get_admin_schema`      | Fetch the full Admin API schema introspection            |
+| `list_admin_operations` | List all available Admin API queries and mutations       |
 
 ### Shop API
-| Tool | Description |
-|------|-------------|
-| `shop_query` | Execute a GraphQL query on the Shop API |
-| `shop_mutation` | Execute a GraphQL mutation on the Shop API |
-| `shop_batch_mutation` | Execute a mutation in bulk for multiple IDs (concurrent) |
-| `get_shop_schema` | Fetch the full Shop API schema introspection |
-| `list_shop_operations` | List all available Shop API queries and mutations |
+
+| Tool                   | Description                                              |
+| ---------------------- | -------------------------------------------------------- |
+| `shop_query`           | Execute a GraphQL query on the Shop API                  |
+| `shop_mutation`        | Execute a GraphQL mutation on the Shop API               |
+| `shop_batch_mutation`  | Execute a mutation in bulk for multiple IDs (concurrent) |
+| `get_shop_schema`      | Fetch the full Shop API schema introspection             |
+| `list_shop_operations` | List all available Shop API queries and mutations        |
 
 ### Batch Mutations
 
 The batch mutation tools allow you to run a single mutation across multiple IDs concurrently. Useful for bulk operations like deleting or updating many records at once.
 
 **Parameters:**
+
 - `mutation` (required) — GraphQL mutation string with an ID variable (e.g. `$id: ID!`)
 - `ids` (required) — Array of IDs to run the mutation for
 - `variableName` — Name of the ID variable in the mutation (default: `"id"`)
@@ -59,6 +64,7 @@ The batch mutation tools allow you to run a single mutation across multiple IDs
 - `concurrency` — Max concurrent mutations (default: `5`)
 
 **Example — bulk delete products:**
+
 ```json
 {
   "mutation": "mutation DeleteProduct($id: ID!) { deleteProduct(id: $id) { result } }",
@@ -68,14 +74,23 @@ The batch mutation tools allow you to run a single mutation across multiple IDs
 ```
 
 **Returns per-ID results:**
+
 ```json
 {
   "total": 3,
   "succeeded": 2,
   "failed": 1,
   "results": [
-    { "id": "1", "success": true, "data": { "deleteProduct": { "result": "DELETED" } } },
-    { "id": "2", "success": true, "data": { "deleteProduct": { "result": "DELETED" } } },
+    {
+      "id": "1",
+      "success": true,
+      "data": { "deleteProduct": { "result": "DELETED" } }
+    },
+    {
+      "id": "2",
+      "success": true,
+      "data": { "deleteProduct": { "result": "DELETED" } }
+    },
     { "id": "3", "success": false, "error": "Product not found" }
   ]
 }

package/dist/index.js

@@ -23,6 +23,30 @@ if (existsSync(apiKeyPath)) {
     }
 }
 import { adminQuery, adminMutation, adminBatchMutation, getAdminSchema, getAdminOperations, shopQuery, shopMutation, shopBatchMutation, getShopSchema, getShopOperations, } from "./src/tools/index.js";
+// Singleton pattern for shared resources
+class SharedResources {
+    static instance = null;
+    static initializing = false;
+    constructor() { }
+    static async getInstance() {
+        if (this.instance)
+            return this.instance;
+        while (this.initializing) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        if (this.instance)
+            return this.instance;
+        this.initializing = true;
+        try {
+            // Initialize any shared resources here if needed
+            this.instance = new SharedResources();
+            return this.instance;
+        }
+        finally {
+            this.initializing = false;
+        }
+    }
+}
 const server = new Server({
     name: "vendure-mcp-graphql",
     version: "1.0.0",
@@ -285,9 +309,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 // Start the server
 async function main() {
+    // Initialize shared resources (singleton pattern)
+    await SharedResources.getInstance();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("Vendure GraphQL MCP server running on stdio");
+    console.error("Memory optimization: GraphQL client shared via singleton");
     console.error(`API Key: ${process.env.VENDURE_API_KEY ? "Present" : "Missing"}`);
     console.error(`Admin URL: ${process.env.ADMIN_API_URL || "default"}`);
     console.error(`Shop URL: ${process.env.SHOP_API_URL || "default"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vendure-mcp-graphql",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "MCP server for Vendure Admin and Shop GraphQL APIs",
   "type": "module",
   "bin": {