n8n-nodes-mcp-local 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philflow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# n8n-nodes-mcp-local
+
+**Transform any MCP server into native AI Agent tools.**
+
+[![npm version](https://badge.fury.io/js/n8n-nodes-mcp-local.svg)](https://www.npmjs.com/package/n8n-nodes-mcp-local)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Quick Start
+
+1. **Install**: Settings → Community Nodes → `n8n-nodes-mcp-local`
+2. **Workflow**: Add AI Agent + MCP Local Provider → Connect via tool
+3. **Credentials**: Create "MCP Server (STDIO)" → Package: `wikipedia-mcp` → **Save** triggers `npx` and discovers tools
+4. **Done.** All MCP tools appear at your Agent.
+
+---
+
+## Why This Node?
+
+Most MCP servers are **STDIO-based** — designed to run locally via `npx`. n8n has two existing options, but neither gives you direct access:
+
+|  | [n8n Native MCP](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/) | [nerding.io MCP](https://github.com/nerding-io/n8n-nodes-mcp) | **This Node** |
+|--|:--------------:|:--------------:|:-------------:|
+| **STDIO / npx** | ❌ | ✅ | ✅ |
+| **SSE / HTTP** | ✅ | ✅ | ❌ |
+| **Agent sees individual tools** | ✅ | ❌ | ✅ |
+| **Tool selection (include/exclude)** | ✅ | ❌ | ✅ |
+
+### What's Missing
+
+**n8n Native** gives you clean Agent integration, but no STDIO. You'd need to host MCP servers yourself.
+
+**nerding.io** has STDIO, but requires two separate nodes for every call. The Agent never sees actual tools — just a "List Tools" and "Execute Tool" wrapper. More indirection, less reliable tool calls.
+
+---
+
+
+### Direct Access
+
+```
+nerding.io:   Agent → "List Tools" → "Execute Tool" → Result
+This node:    Agent → tool_name() → Result
+```
+
+No detours. The Agent sees every tool, reads its description, and calls it like any native function.
+
+---
+
+## Built for Flow
+
+This node uses `npx` — the MCP server is fetched on every execution
+
+No setup friction. Test ideas, iterate fast, ship when it works.
+
+When you're ready for production scale with high-frequency calls, host your MCP server and switch to the native n8n MCP Client.
+
+---
+
+## How It Works
+
+```
+┌──────────────────┐       ┌──────────────────┐
+│  MCP Local       │──────►│    AI Agent      │
+│  Provider        │       │                  │
+└──────────────────┘       └──────────────────┘
+         │
+         ▼
+    npx wikipedia-mcp
+         │
+         ▼
+    Tools discovered & registered:
+    • store_memory
+    • retrieve_memory
+    • list_memories
+```
+
+---
+
+## Configuration
+
+### Credentials
+
+| Field | Description | Example |
+|-------|-------------|---------|
+| **MCP Package** | npm package name | `wikipedia-mcp` |
+| **Environment Variables** | Optional config | `API_KEY=xxx` |
+
+### Node Options
+
+| Option | Description |
+|--------|-------------|
+| **Tools Mode** | all / selected / exclude |
+| **Include/Exclude Tools** | Filter which tools the Agent sees |
+
+---
+
+## Troubleshooting
+
+**First run slow?**
+`npx` downloads the package. Subsequent runs use npm cache.
+
+**No tools discovered?**
+Check package name. Some servers need environment variables.
+
+---
+
+## License
+
+MIT
+
+## Credits
+
+[Model Context Protocol](https://modelcontextprotocol.io/) by Anthropic • [n8n](https://n8n.io/)
+
+---
+
+Build something. Ship it.

package/dist/credentials/McpServerApi.credentials.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Server API Credentials
+ *
+ * Stores MCP Server connection configuration for reuse across workflows.
+ * Simplified: Just enter the MCP package name, we handle the rest.
+ */
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class McpServerApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}
+//# sourceMappingURL=McpServerApi.credentials.d.ts.map

package/dist/credentials/McpServerApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServerApi.credentials.d.ts","sourceRoot":"","sources":["../../src/credentials/McpServerApi.credentials.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,qBAAa,YAAa,YAAW,eAAe;IAClD,IAAI,SAAkB;IACtB,WAAW,SAAwB;IACnC,gBAAgB,SAAsC;IAEtD,UAAU,EAAE,eAAe,EAAE,CAuB3B;CACH"}

package/dist/credentials/McpServerApi.credentials.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * MCP Server API Credentials
+ *
+ * Stores MCP Server connection configuration for reuse across workflows.
+ * Simplified: Just enter the MCP package name, we handle the rest.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerApi = void 0;
+class McpServerApi {
+    name = 'mcpServerApi';
+    displayName = 'MCP Server (STDIO)';
+    documentationUrl = 'https://modelcontextprotocol.io/';
+    properties = [
+        {
+            displayName: 'MCP Package',
+            name: 'mcpPackage',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: '@anthropic/mcp-server-memory',
+            description: 'NPM package name of the MCP server (e.g., firecrawl-mcp, @anthropic/mcp-server-memory)',
+        },
+        {
+            displayName: 'Environment Variables',
+            name: 'envVars',
+            type: 'string',
+            default: '',
+            typeOptions: {
+                password: true,
+            },
+            placeholder: 'API_KEY=xxx,SECRET=yyy',
+            description: 'Environment variables in NAME=VALUE format, comma-separated. Values are stored securely.',
+        },
+    ];
+}
+exports.McpServerApi = McpServerApi;
+//# sourceMappingURL=McpServerApi.credentials.js.map

package/dist/credentials/McpServerApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServerApi.credentials.js","sourceRoot":"","sources":["../../src/credentials/McpServerApi.credentials.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAa,YAAY;IACvB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,oBAAoB,CAAC;IACnC,gBAAgB,GAAG,kCAAkC,CAAC;IAEtD,UAAU,GAAsB;QAC9B;YACE,WAAW,EAAE,aAAa;YAC1B,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,8BAA8B;YAC3C,WAAW,EACT,wFAAwF;SAC3F;QACD;YACE,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EAAE;gBACX,QAAQ,EAAE,IAAI;aACf;YACD,WAAW,EAAE,wBAAwB;YACrC,WAAW,EACT,0FAA0F;SAC7F;KACF,CAAC;CACH;AA7BD,oCA6BC"}

package/dist/credentials/index.d.ts

@@ -0,0 +1,2 @@
+export { McpServerApi } from './McpServerApi.credentials.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/credentials/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/credentials/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/credentials/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerApi = void 0;
+var McpServerApi_credentials_js_1 = require("./McpServerApi.credentials.js");
+Object.defineProperty(exports, "McpServerApi", { enumerable: true, get: function () { return McpServerApi_credentials_js_1.McpServerApi; } });
+//# sourceMappingURL=index.js.map

package/dist/credentials/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/credentials/index.ts"],"names":[],"mappings":";;;AAAA,6EAA6D;AAApD,2HAAA,YAAY,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './nodes/McpToolsProvider/McpToolsProvider.node.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,mDAAmD,CAAC;AAClE,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+// n8n-nodes-mcp-tools
+// MCP Tools Provider - STDIO MCP Server with Auto-Tool-Listing
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nodes/McpToolsProvider/McpToolsProvider.node.js"), exports);
+__exportStar(require("./types.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sBAAsB;AACtB,+DAA+D;;;;;;;;;;;;;;;;AAE/D,oFAAkE;AAClE,6CAA2B"}

package/dist/nodes/McpToolsProvider/McpToolsProvider.node.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP Tools Provider Node
+ *
+ * Lädt Tools von einem MCP Server via STDIO und stellt sie
+ * dem AI Agent als LangChain Tools zur Verfügung.
+ *
+ * Features:
+ * - Tool caching for instant dropdown loading
+ * - Tool selection (all, selected, except)
+ * - Debug mode for troubleshooting
+ */
+import type { INodeType, INodeTypeDescription, ISupplyDataFunctions, IExecuteFunctions, INodeExecutionData, SupplyData, ILoadOptionsFunctions, INodePropertyOptions, ICredentialTestFunctions, ICredentialsDecrypted, ICredentialDataDecryptedObject, INodeCredentialTestResult } from 'n8n-workflow';
+export declare class McpToolsProvider implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        credentialTest: {
+            mcpServerConnectionTest(this: ICredentialTestFunctions, credential: ICredentialsDecrypted<ICredentialDataDecryptedObject>): Promise<INodeCredentialTestResult>;
+        };
+        loadOptions: {
+            getTools(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
+    supplyData(this: ISupplyDataFunctions, itemIndex: number): Promise<SupplyData>;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=McpToolsProvider.node.d.ts.map

package/dist/nodes/McpToolsProvider/McpToolsProvider.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpToolsProvider.node.d.ts","sourceRoot":"","sources":["../../../src/nodes/McpToolsProvider/McpToolsProvider.node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AA4KtB,qBAAa,gBAAiB,YAAW,SAAS;IAChD,WAAW,EAAE,oBAAoB,CA+E/B;IAGF,OAAO;;0CAGK,wBAAwB,cAClB,qBAAqB,CAAC,8BAA8B,CAAC,GAChE,OAAO,CAAC,yBAAyB,CAAC;;;2BAoChB,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;MAmC9E;IAEI,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA+I9E,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA2JxE"}