@thecodesaiyan/tcs-n8n-mcp 1.1.1 → 1.3.0

package/README.md

@@ -41,19 +41,18 @@ An [MCP](https://modelcontextprotocol.io) server that gives AI assistants full c
 
 ### Quick Start
 
-```bash
-npx @thecodesaiyan/tcs-n8n-mcp
-```
-
-### Interactive Setup Wizard
-
-The setup wizard walks you through configuration and tests your connection:
-
 ```bash
 npx @thecodesaiyan/tcs-n8n-mcp --setup
 ```
 
-It will prompt for your n8n URL, auth type, and credentials, then output ready-to-paste config for your MCP client.
+The setup wizard walks you through configuration, tests your connection, and outputs ready-to-paste config for your MCP client.
+
+> **Windows users:** `npx` cannot resolve bin commands from scoped packages on Windows. Install globally instead:
+>
+> ```bash
+> npm install -g @thecodesaiyan/tcs-n8n-mcp
+> tcs-n8n-mcp --setup
+> ```
 
 ### Environment Variables
 
@@ -86,14 +85,25 @@ npx @thecodesaiyan/tcs-n8n-mcp --setup
 
 #### Option B: CLI command
 
+**macOS / Linux:**
+
 ```bash
 claude mcp add n8n -e N8N_API_URL=http://localhost:5678 -e N8N_API_KEY=your-api-key -- npx -y @thecodesaiyan/tcs-n8n-mcp
 ```
 
+**Windows** (install globally first):
+
+```bash
+npm install -g @thecodesaiyan/tcs-n8n-mcp
+claude mcp add n8n -e N8N_API_URL=http://localhost:5678 -e N8N_API_KEY=your-api-key -- tcs-n8n-mcp
+```
+
 #### Option C: Manual config
 
 Add to `~/.claude.json`:
 
+**macOS / Linux:**
+
 ```json
 {
   "mcpServers": {
@@ -109,6 +119,23 @@ Add to `~/.claude.json`:
 }
 ```
 
+**Windows:**
+
+```json
+{
+  "mcpServers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
+
 </details>
 
 <details>
@@ -122,6 +149,8 @@ Add to your Claude Desktop config file:
 | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
 | Linux | `~/.config/Claude/claude_desktop_config.json` |
 
+**macOS / Linux:**
+
 ```json
 {
   "mcpServers": {
@@ -137,6 +166,23 @@ Add to your Claude Desktop config file:
 }
 ```
 
+**Windows** (run `npm install -g @thecodesaiyan/tcs-n8n-mcp` first):
+
+```json
+{
+  "mcpServers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
+
 > Restart Claude Desktop after saving.
 
 </details>
@@ -146,6 +192,8 @@ Add to your Claude Desktop config file:
 
 Add to `.vscode/mcp.json` in your project, or use **Command Palette** > `MCP: Open User Configuration`:
 
+**macOS / Linux:**
+
 ```json
 {
   "servers": {
@@ -161,6 +209,23 @@ Add to `.vscode/mcp.json` in your project, or use **Command Palette** > `MCP: Op
 }
 ```
 
+**Windows** (run `npm install -g @thecodesaiyan/tcs-n8n-mcp` first):
+
+```json
+{
+  "servers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
+
 </details>
 
 <details>
@@ -168,6 +233,8 @@ Add to `.vscode/mcp.json` in your project, or use **Command Palette** > `MCP: Op
 
 Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-level):
 
+**macOS / Linux:**
+
 ```json
 {
   "mcpServers": {
@@ -183,6 +250,23 @@ Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-level):
 }
 ```
 
+**Windows** (run `npm install -g @thecodesaiyan/tcs-n8n-mcp` first):
+
+```json
+{
+  "mcpServers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
+
 </details>
 
 <details>
@@ -195,6 +279,8 @@ Add to your Windsurf config file:
 | Windows | `%USERPROFILE%\.codeium\windsurf\mcp_config.json` |
 | macOS / Linux | `~/.codeium/windsurf/mcp_config.json` |
 
+**macOS / Linux:**
+
 ```json
 {
   "mcpServers": {
@@ -210,6 +296,23 @@ Add to your Windsurf config file:
 }
 ```
 
+**Windows** (run `npm install -g @thecodesaiyan/tcs-n8n-mcp` first):
+
+```json
+{
+  "mcpServers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
+
 </details>
 
 <details>
@@ -217,6 +320,8 @@ Add to your Windsurf config file:
 
 Open **MCP Servers** > **Configure** > **Advanced MCP Settings** and add:
 
+**macOS / Linux:**
+
 ```json
 {
   "mcpServers": {
@@ -232,7 +337,22 @@ Open **MCP Servers** > **Configure** > **Advanced MCP Settings** and add:
 }
 ```
 
-> **Windows**: If you encounter spawn errors, use `"command": "cmd"` with `"args": ["/c", "npx", "-y", "@thecodesaiyan/tcs-n8n-mcp"]`.
+**Windows** (run `npm install -g @thecodesaiyan/tcs-n8n-mcp` first):
+
+```json
+{
+  "mcpServers": {
+    "n8n": {
+      "command": "tcs-n8n-mcp",
+      "args": [],
+      "env": {
+        "N8N_API_KEY": "your-api-key-here",
+        "N8N_API_URL": "http://localhost:5678"
+      }
+    }
+  }
+}
+```
 
 </details>
 

package/build/index.js

@@ -82,16 +82,24 @@ async function runSetup() {
         env.N8N_API_USER = apiUser;
     }
     const pkg = "@thecodesaiyan/tcs-n8n-mcp";
-    const stdioCfg = {
-        command: "npx",
-        args: ["-y", pkg],
-        env,
-    };
+    const isWindows = process.platform === "win32";
+    const stdioCfg = isWindows
+        ? { command: "tcs-n8n-mcp", args: [], env }
+        : { command: "npx", args: ["-y", pkg], env };
     const envFlags = Object.entries(env)
         .map(([k, v]) => `-e ${k}=${v}`)
         .join(" ");
+    if (isWindows) {
+        console.log("  ── Prerequisites (Windows) ──");
+        console.log(`  npm install -g ${pkg}\n`);
+    }
     console.log("  ── Claude Code ──");
-    console.log(`  claude mcp add tcs-n8n-mcp ${envFlags} -- npx -y ${pkg}\n`);
+    if (isWindows) {
+        console.log(`  claude mcp add tcs-n8n-mcp ${envFlags} -- tcs-n8n-mcp\n`);
+    }
+    else {
+        console.log(`  claude mcp add tcs-n8n-mcp ${envFlags} -- npx -y ${pkg}\n`);
+    }
     console.log("  ── Claude Desktop / Windsurf ──");
     console.log("  Add to your config JSON under \"mcpServers\":\n");
     console.log(`  "tcs-n8n-mcp": ${JSON.stringify(stdioCfg, null, 4)}\n`);
@@ -140,7 +148,7 @@ const n8nFetch = (path, options = {}) => {
 };
 const server = new McpServer({
     name: "@thecodesaiyan/tcs-n8n-mcp",
-    version: "1.1.1",
+    version: "1.3.0",
 });
 // Register all tool modules
 registerWorkflowTools(server, n8nFetch);
@@ -157,7 +165,7 @@ async function main() {
     }
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("@thecodesaiyan/tcs-n8n-mcp v1.1.1 running on stdio (22 tools)");
+    console.error("@thecodesaiyan/tcs-n8n-mcp v1.3.0 running on stdio (22 tools)");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thecodesaiyan/tcs-n8n-mcp",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "MCP server for n8n workflow automation. Manage workflows, executions, tags, variables, credentials and users via the Model Context Protocol.",
   "type": "module",
   "main": "build/index.js",