Compare commits

...

10 Commits

Author SHA1 Message Date
Romuald Członkowski
0ef69fbf75 Merge pull request #196 from czlonkowski/n8n-dependencies-update
Dependencies Updated
n8n: 1.110.1 → 1.111.0
n8n-core: 1.110.0 (unchanged, latest)
n8n-workflow: 1.108.0 (unchanged, latest)
@n8n/n8n-nodes-langchain: 1.109.1 → 1.110.0
2025-09-16 12:24:57 +02:00
czlonkowski
f39c9a5389 fix: resolve pyodide version conflict for Docker builds
- Added override for pyodide@0.26.4 to resolve version conflict
- @langchain/community requires pyodide <0.27.0 but npm was installing 0.28.0
- This was causing Railway Docker build failures with npm ci

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:59:45 +02:00
czlonkowski
92d7577f22 fix: regenerate package-lock.json and update runtime version
- Regenerated package-lock.json with all dependencies properly resolved
- Updated package.runtime.json version to 2.11.2 to match main package
- This should fix Railway Docker build failures

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:51:53 +02:00
czlonkowski
874aea6920 chore: bump version to 2.11.2 and update documentation
- Bumped version from 2.11.1 to 2.11.2
- Updated README version badge to 2.11.2
- Updated README n8n version badge to ^1.111.0
- Added comprehensive CHANGELOG entry for v2.11.2
- Documented n8n dependency updates and test results

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:17:24 +02:00
czlonkowski
19caa7bbb4 2.11.2 2025-09-16 11:14:56 +02:00
czlonkowski
dff0387ae2 chore: update n8n dependencies to v1.111.0
- Updated n8n from 1.110.1 to 1.111.0
- Updated n8n-core from 1.109.0 to 1.110.0
- Updated n8n-workflow from 1.107.0 to 1.108.0
- Updated @n8n/n8n-nodes-langchain from 1.109.1 to 1.110.0
- Rebuilt node database with 535 nodes
- Templates preserved: 2598 templates with 2534 having metadata
- All critical nodes validated successfully
- Test results: 1911 passed, 5 failed (performance tests), 53 skipped

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:14:24 +02:00
Romuald Członkowski
469cc1720d Merge pull request #195 from czlonkowski/templates-update
Summary
Added optional fields parameter to search_templates tool to allow selective field filtering
Reduces response size by 70-98% when requesting only specific fields (e.g., just id and name)
Maintains full backward compatibility - all existing calls continue to work unchanged
Changes
Updated tool definition with new fields parameter
Modified template service to support partial responses
Updated tool documentation with examples
Bumped version to 2.11.1
Benefits
98% reduction in response size when requesting only id/name fields
70% reduction when including description
Significantly reduces token usage for AI agents
Maintains backward compatibility
Test Results
 All unit tests passing
 All integration tests passing
 TypeScript linting successful
 Manual testing confirmed 98% size reduction
2025-09-16 00:02:23 +02:00
czlonkowski
99cdae7655 fix: update package-lock.json version to 2.11.1 2025-09-15 23:53:32 +02:00
czlonkowski
16e6a1fc44 Merge branch 'main' of https://github.com/czlonkowski/n8n-mcp 2025-09-15 11:29:33 +02:00
Romuald Członkowski
03c4e3b9a5 Merge pull request #194 from czlonkowski/templates-update
Summary
Major enhancement to the template system with AI-powered metadata generation, smart template discovery, and improved search capabilities for n8n workflow templates.

Key Achievements
📈 5x more templates: Expanded from 499 to 2,596 high-quality templates
🤖 AI-powered metadata: Automatic generation of structured metadata using OpenAI
🔍 Smart template discovery: Search by complexity, setup time, required services, and more
🗜️ Efficient compression: Gzip compression keeps database size manageable
🚀 Token usage reduced by 80-90%: New flexible retrieval modes
🎯 Fuzzy node matching: Find templates using similar node types
Major Features Added
1. AI-Powered Template Metadata Generation 🤖
Structured metadata automatically generated for all templates using OpenAI
Batch processing with OpenAI Batch API for cost-effective generation
Rich categorization: Categories, complexity levels, use cases, key features
Setup time estimates: Helps users understand implementation effort
Target audience identification: Matches templates to user roles
Required services tracking: Lists external APIs and services needed
2. Smart Template Discovery System 🔍
New Search Capabilities
Search by metadata: Filter templates by categories, complexity, setup time
Multi-faceted search: Combine filters for precise template discovery
Fuzzy node matching: Find templates with similar nodes (e.g., Gmail ≈ Outlook)
SQL injection protection: Secure parameterized queries throughout
New MCP Tools for Template Discovery
search_templates_by_metadata: Smart search with metadata filters
list_node_templates: Find templates using specific nodes (with fuzzy matching)
get_templates_for_task: Curated templates for common tasks
list_templates: Browse all templates with metadata
3. Template System Infrastructure 🏗️
Database Enhancements
New metadata columns: metadata_json, metadata_generated_at
Gzip compression: Workflow JSONs compressed (12MB vs 75MB uncompressed)
Quality filtering: Only templates with >10 views included
Token sanitization: Automatic removal of API keys/secrets from templates
Flexible Retrieval Modes
Three response modes for different use cases:

nodes_only: Just node types and names (minimal tokens)
structure: Nodes with positions and connections (moderate detail)
full: Complete workflow JSON (maximum detail)
4. Comprehensive Testing & Security 🛡️
Security Features
SQL injection prevention: All queries use parameterized statements
Input validation: Comprehensive sanitization of user inputs
Token removal: Automatic sanitization of API keys in templates
Directory traversal protection: Safe file path handling
Test Coverage
 25+ integration tests for metadata operations
 20+ security tests for SQL injection prevention
 Unit tests for all new components
 Performance tests for batch processing
 All tests passing (120+ tests total)
Impact Analysis
Metric	Main Branch	This PR	Change
Template Count	499	2,596	+420% (5x)
Templates with Metadata	0	2,596	100% coverage
Search Capabilities	Basic text	Smart metadata filters	Major enhancement
Token Usage (minimal mode)	100%	10-20%	80-90% reduction
Database Size	~40MB	~48MB	+20% (acceptable)
New API Examples
Smart Template Search
// Find simple automation templates that take less than 30 minutes to set up
search_templates_by_metadata({
  category: 'automation',
  complexity: 'simple',
  maxSetupMinutes: 30
}, limit: 10)
Fuzzy Node Matching
// Find templates with email nodes (matches Gmail, Outlook, SMTP, etc.)
list_node_templates({
  nodeTypes: ['n8n-nodes-base.gmail']
})
// Automatically finds templates with similar email nodes
Task-Based Discovery
// Get curated templates for specific tasks
get_templates_for_task({
  task: 'webhook_processing'
})
Metadata Statistics
// Get insights into template metadata coverage
get_metadata_stats()
// Returns: { total: 2596, withMetadata: 2596, outdated: 0, ... }
Files Changed Summary
New Components
src/templates/metadata-generator.ts: OpenAI metadata generation
src/templates/batch-processor.ts: Batch API processing
src/utils/node-similarity.ts: Fuzzy node matching logic
src/utils/template-sanitizer.ts: Token removal and sanitization
tests/integration/templates/metadata-operations.test.ts: Integration tests
tests/unit/templates/template-repository-security.test.ts: Security tests
Enhanced Components
src/templates/template-repository.ts: Metadata operations & smart search
src/templates/template-service.ts: Pagination & flexible retrieval
src/templates/template-fetcher.ts: Metadata generation integration
src/mcp/tools.ts: New template discovery tools
src/database/schema.sql: Metadata columns added
Migration Notes
Existing databases will be automatically migrated on first run
Metadata generation is optional (use --generate-metadata flag)
All existing tools remain backward compatible
Compression is transparent to API consumers
Test Plan
 Run full test suite: npm test
 Test metadata generation with OpenAI
 Verify smart search capabilities
 Test fuzzy node matching
 Verify SQL injection prevention
 Test compression/decompression
 Verify pagination logic
 Test all three get_template modes
 Check memory usage with large templates
 Test with n8n-mcp-tester agent
Documentation
Updated README with new template tools
Added metadata generation guide in docs/
Claude Project Setup updated with new capabilities
2025-09-15 10:09:10 +02:00
6 changed files with 12318 additions and 4441 deletions

View File

@@ -2,11 +2,11 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/czlonkowski/n8n-mcp?style=social)](https://github.com/czlonkowski/n8n-mcp)
[![Version](https://img.shields.io/badge/version-2.11.1-blue.svg)](https://github.com/czlonkowski/n8n-mcp)
[![Version](https://img.shields.io/badge/version-2.11.2-blue.svg)](https://github.com/czlonkowski/n8n-mcp)
[![npm version](https://img.shields.io/npm/v/n8n-mcp.svg)](https://www.npmjs.com/package/n8n-mcp)
[![codecov](https://codecov.io/gh/czlonkowski/n8n-mcp/graph/badge.svg?token=YOUR_TOKEN)](https://codecov.io/gh/czlonkowski/n8n-mcp)
[![Tests](https://img.shields.io/badge/tests-1728%20passing-brightgreen.svg)](https://github.com/czlonkowski/n8n-mcp/actions)
[![n8n version](https://img.shields.io/badge/n8n-^1.110.1-orange.svg)](https://github.com/n8n-io/n8n)
[![n8n version](https://img.shields.io/badge/n8n-^1.111.0-orange.svg)](https://github.com/n8n-io/n8n)
[![Docker](https://img.shields.io/badge/docker-ghcr.io%2Fczlonkowski%2Fn8n--mcp-green.svg)](https://github.com/czlonkowski/n8n-mcp/pkgs/container/n8n-mcp)
[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/n8n-mcp?referralCode=n8n-mcp)

Binary file not shown.

View File

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [2.11.2] - 2025-09-16
### Updated
- **n8n Dependencies**: Updated to latest versions for compatibility and new features
- n8n: 1.110.1 → 1.111.0
- n8n-core: 1.109.0 → 1.110.0
- n8n-workflow: 1.107.0 → 1.108.0
- @n8n/n8n-nodes-langchain: 1.109.1 → 1.110.0
- **Node Database**: Rebuilt with 535 nodes from updated n8n packages
- **Templates**: Preserved all 2,598 workflow templates with metadata intact
- All critical nodes validated successfully (httpRequest, code, slack, agent)
- Test suite: 1,911 tests passing, 5 flaky performance tests failing (99.7% pass rate)
## [2.11.1] - 2025-09-15
### Added
@@ -1297,6 +1310,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Basic n8n and MCP integration
- Core workflow automation features
[2.11.2]: https://github.com/czlonkowski/n8n-mcp/compare/v2.11.1...v2.11.2
[2.11.1]: https://github.com/czlonkowski/n8n-mcp/compare/v2.11.0...v2.11.1
[2.11.0]: https://github.com/czlonkowski/n8n-mcp/compare/v2.10.9...v2.11.0
[2.10.9]: https://github.com/czlonkowski/n8n-mcp/compare/v2.10.8...v2.10.9

16726
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -1,6 +1,6 @@
{
"name": "n8n-mcp",
"version": "2.11.1",
"version": "2.11.2",
"description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
"main": "dist/index.js",
"bin": {
@@ -128,12 +128,12 @@
},
"dependencies": {
"@modelcontextprotocol/sdk": "^1.13.2",
"@n8n/n8n-nodes-langchain": "^1.109.1",
"@n8n/n8n-nodes-langchain": "^1.110.0",
"dotenv": "^16.5.0",
"express": "^5.1.0",
"n8n": "^1.110.1",
"n8n-core": "^1.109.0",
"n8n-workflow": "^1.107.0",
"n8n": "^1.111.0",
"n8n-core": "^1.110.0",
"n8n-workflow": "^1.108.0",
"openai": "^4.77.0",
"sql.js": "^1.13.0",
"uuid": "^10.0.0",
@@ -143,5 +143,8 @@
"@rollup/rollup-darwin-arm64": "^4.50.0",
"@rollup/rollup-linux-x64-gnu": "^4.50.0",
"better-sqlite3": "^11.10.0"
},
"overrides": {
"pyodide": "0.26.4"
}
}

View File

@@ -1,6 +1,6 @@
{
"name": "n8n-mcp-runtime",
"version": "2.10.9",
"version": "2.11.2",
"description": "n8n MCP Server Runtime Dependencies Only",
"private": true,
"dependencies": {