Commit Graph

257 Commits

Author SHA1 Message Date
czlonkowski
b49043171e test: Phase 3 - Create comprehensive unit tests for services
- Add unit tests for ConfigValidator with 44 test cases (95.21% coverage)
- Create test templates for 7 major services:
  - PropertyFilter (23 tests)
  - ExampleGenerator (35 tests)
  - TaskTemplates (36 tests)
  - PropertyDependencies (21 tests)
  - EnhancedConfigValidator (8 tests)
  - ExpressionValidator (11 tests)
  - WorkflowValidator (9 tests)
- Fix service implementations to handle edge cases discovered during testing
- Add comprehensive testing documentation:
  - Phase 3 testing plan with priorities and timeline
  - Context documentation for quick implementation
  - Mocking strategy for complex dependencies
- All 262 tests now passing (up from 75)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-28 14:15:09 +02:00
czlonkowski
45b271c860 fix: resolve TypeScript and linting errors in test infrastructure
- Add @types/better-sqlite3 dependency
- Remove duplicate database mock file
- Fix property spread order in workflow builder to prevent overwrites
- All 75 tests now pass with no linting errors

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-28 13:26:00 +02:00
czlonkowski
17013d8a25 test: Phase 2 - Create test infrastructure
- Create comprehensive test directory structure
- Implement better-sqlite3 mock for Vitest
- Add node factory using fishery for test data generation
- Create workflow builder with fluent API
- Add infrastructure validation tests
- Update testing checklist to reflect progress

All Phase 2 tasks completed successfully with 7 tests passing.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-28 13:21:56 +02:00
czlonkowski
aa3b2a8460 test: migrate from Jest to Vitest (Phase 1 complete)
- Remove Jest and all related packages
- Install Vitest with coverage support
- Create vitest.config.ts with path aliases
- Set up global test configuration
- Migrate all 6 test files to Vitest syntax
- Update TypeScript configuration for better Vitest support
- Create separate tsconfig.build.json for clean builds
- Fix all import/module issues in tests
- All 68 tests passing successfully
- Current coverage baseline: 2.45%

Phase 1 of testing suite improvement complete.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-28 13:05:38 +02:00
czlonkowski
d44ec49814 docs: mark Phase 0 as completed in testing documentation
- Updated checklist to show completed tasks
- Marked Phase 0 as completed in AI-optimized guide
- GitHub Actions workflow confirmed working
2025-07-28 12:11:35 +02:00
czlonkowski
cf960ed2ac test: phase 0 - fix failing tests and setup CI/CD
- Fixed 6 failing tests across http-server-auth.test.ts and single-session.test.ts
- All tests now pass (68 passing, 0 failing)
- Added GitHub Actions workflow for automated testing
- Added comprehensive testing documentation and strategy
- Tests fixed without changing application behavior
2025-07-28 12:04:38 +02:00
czlonkowski
5450bc35c3 Add agents to Claude Code 2025-07-28 10:21:03 +02:00
czlonkowski
23d12b4808 chore: upgrade Docker base images to Node.js 22 LTS Alpine (v2.7.22)
- Updated all Dockerfiles from node:20-alpine to node:22-alpine
- Addresses known vulnerabilities in older Alpine images
- Provides better long-term support with Node.js 22 LTS (until April 2027)
- Updated documentation to reflect new base image version
- Tested and verified compatibility with all dependencies

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-28 09:23:23 +02:00
czlonkowski
eeb73e1779 chore: update n8n to v1.103.2
- Updated n8n from 1.102.4 to 1.103.2
- Updated n8n-core from 1.101.2 to 1.102.1
- Updated n8n-workflow from 1.99.1 to 1.100.0
- Updated @n8n/n8n-nodes-langchain from 1.101.2 to 1.102.1
- Rebuilt node database with 532 nodes
- Bumped version to 2.7.21
- All validation tests passing

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-23 19:19:50 +02:00
czlonkowski
04e0739bbd docs: update Docker docs to use --init flag and fix container cleanup issues 2025-07-18 19:22:02 +02:00
czlonkowski
6e52afd5af fix: Docker container cleanup on session end (Issue #66)
- Added proper SIGTERM/SIGINT signal handlers to stdio-wrapper.ts
- Removed problematic trap commands from docker-entrypoint.sh
- Added STOPSIGNAL directive to Dockerfile for explicit signal handling
- Implemented graceful shutdown in MCP server with database cleanup
- Added stdin close detection for proper cleanup when Claude Desktop closes the pipe
- Containers now properly exit with the --rm flag, preventing accumulation
- Added --init flag to all Docker configuration examples
- Updated documentation with container lifecycle management best practices
- Bumped version to 2.7.20

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 18:51:24 +02:00
czlonkowski
f76e2247f9 fix: enhance node type format normalization for better AI agent compatibility (Issue #74)
- Added support for n8n-nodes-langchain.* → nodes-langchain.* normalization
- Implemented case-insensitive node name matching (e.g., chattrigger → chatTrigger)
- Added smart camelCase detection for common patterns (trigger, request, sheets, etc.)
- Fixed get_node_documentation tool to use same normalization logic as other tools
- Updated all 7 node lookup locations to use normalized types for alternatives
- Enhanced getNodeTypeAlternatives() to normalize all generated alternatives

All MCP tools now consistently handle various format variations:
- nodes-langchain.chatTrigger (correct format)
- n8n-nodes-langchain.chatTrigger (package format)
- n8n-nodes-langchain.chattrigger (package + wrong case)
- nodes-langchain.chattrigger (wrong case only)
- @n8n/n8n-nodes-langchain.chatTrigger (full npm format)

Bump version to 2.7.19

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 16:25:20 +02:00
czlonkowski
a7bcd8cd1b docs: add n8n version compatibility notice in tools documentation 2025-07-18 15:20:38 +02:00
czlonkowski
159110d5c4 chore: update n8n to v1.102.4 and update badges
- Updated n8n from 1.101.1 to 1.102.4
- Updated n8n-core from 1.100.0 to 1.101.2
- Updated n8n-workflow from 1.98.0 to 1.99.1
- Updated @n8n/n8n-nodes-langchain from 1.100.1 to 1.101.2
- Rebuilt node database with 531 nodes
- All validation tests passing
- Updated README.md badges to reflect new versions
- Added reminder to update badges in MEMORY_N8N_UPDATE.md

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 14:43:33 +02:00
czlonkowski
7a025bc1f0 chore: update n8n to v1.102.4
- Updated n8n from 1.101.1 to 1.102.4
- Updated n8n-core from 1.100.0 to 1.101.2
- Updated n8n-workflow from 1.98.0 to 1.99.1
- Updated @n8n/n8n-nodes-langchain from 1.100.1 to 1.101.2
- Rebuilt node database with 531 nodes
- All validation tests passing

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 14:40:58 +02:00
czlonkowski
24cb9e49a0 fix: improve n8n_list_workflows pagination clarity and performance (Issue #54)
- Changed misleading 'total' field to 'returned' to clarify it's the count in current page
- Added 'hasMore' boolean flag for clear pagination indication
- Added '_note' guidance when more data is available
- Applied same improvements to n8n_list_executions for consistency

Performance improvements:
- Tool now returns only minimal metadata instead of full workflow structure
- Reduced response size by ~95% (from thousands to ~10 tokens per workflow)
- Eliminated token limit errors when listing workflows with many nodes
- Updated descriptions and documentation to clarify minimal response

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 14:34:08 +02:00
czlonkowski
a1992f9964 feat: add version info to health check and fix healthz endpoint
- Fixed health check to use correct /healthz endpoint instead of /health
- Added MCP version (mcpVersion) and supported n8n version (supportedN8nVersion) to health check response
- Added versionNote field with instructions for AI agents about manual version verification
- n8n API limitation: instance version cannot be determined automatically
- Updated axios usage for healthz endpoint access with proper error handling
2025-07-18 14:01:11 +02:00
czlonkowski
92d1b7b273 feat: add workflowNodeType field to MCP tool responses for proper n8n workflow creation
- Added workflowNodeType field to all node-returning MCP tools
- AI agents now receive both internal format (nodes-base.webhook) and workflow format (n8n-nodes-base.webhook)
- Created getWorkflowNodeType() utility to construct proper n8n format from package name
- Solves issue where AI agents would search nodes and use wrong format in workflows
- No database changes required - uses existing package_name field
- Updated: search_nodes, get_node_info, get_node_essentials, get_node_as_tool_info, validate_node_operation
- Updated CHANGELOG.md with comprehensive documentation of the changes

This completes the fix for issue #71, ensuring AI agents can seamlessly create workflows
with the correct node type format without manual intervention.
2025-07-18 13:37:05 +02:00
czlonkowski
f8fa782d7f fix: normalize node type prefixes for n8n workflow exports (#71)
- Add centralized normalizeNodeType utility to handle prefix conversion
  - n8n-nodes-base.* → nodes-base.*
  - @n8n/n8n-nodes-langchain.* → nodes-langchain.*
- Update all 9 affected MCP tools to use normalized node types
- AI agents can now use node types directly from n8n workflow exports
- Maintains backward compatibility with existing shortened prefixes
- Add comprehensive test coverage for all affected methods

Fixes #71

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-18 11:31:38 +02:00
czlonkowski
5dd932c19d docs: update HTTP deployment guide with comprehensive improvements
- Add security warnings for default AUTH_TOKEN
- Document AUTH_TOKEN_FILE support
- Add architecture diagram showing stdio → HTTP bridge
- Update configuration with all new env vars
- Improve troubleshooting section
- Add production-ready examples
- Reference Railway deployment guide
- Update to v2.7.17 features

Fixes #72
2025-07-18 09:37:01 +02:00
Romuald Członkowski
70066e94bb Merge pull request #69 from naXa777/patch-2
fix: Ensure error.message is a string before checking for specific messages in workflow validator
2025-07-17 23:36:27 +02:00
czlonkowski
690430577c docs: update CHANGELOG.md for version 2.7.17 2025-07-17 21:36:16 +02:00
czlonkowski
ba7f8f9ea6 fix: remove faulty auto-generated examples from MCP tools
- Remove examples from get_node_essentials responses
- Remove examples from validate_node_operation when errors occur
- Update documentation to reflect removal of examples
- Keep helpful format hints in get_node_for_task (different purpose)

The auto-generated examples were misleading AI agents with incorrect
configurations (e.g., Slack "channel" vs "select" property). Tools
now focus on validation and error messages instead of examples.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 21:35:01 +02:00
czlonkowski
24d775960b refactor: rewrite all MCP tool documentation for AI agent optimization
- Redesigned documentation to be utilitarian and AI-agent focused
- Removed all pleasantries, emojis, and conversational language
- Added concrete numbers throughout (528 nodes, 108 triggers, 264 AI tools)
- Updated all tool descriptions with practical, actionable information
- Enhanced examples with actual return structures and usage patterns
- Made Code node guides prominently featured in overview
- Verified documentation accuracy through extensive testing
- Standardized format across all 30+ tool documentation files

Documentation now optimized for token efficiency while maintaining
clarity and completeness for AI agent consumption.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 21:35:01 +02:00
czlonkowski
c1a6347d4f feat: complete modular documentation system for all MCP tools (#60)
- Migrated all 40 MCP tools documentation to modular structure
- Created comprehensive documentation with both essentials and full details
- Organized tools by category: discovery, configuration, validation, templates, workflow_management, system, special
- Fixed all TODO placeholders with informative, precise content
- Each tool now has concise description, key tips, and full documentation
- Improved documentation quality: 30-40% more concise while maintaining usefulness
- Fixed TypeScript compilation issues and removed orphaned content
- All tools accessible via tools_documentation MCP endpoint
- Build successful with zero errors

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 21:35:00 +02:00
Pavel
89f56bd038 fix: Ensure error.message is a string before checking for specific messages in workflow validator 2025-07-17 16:39:22 +02:00
Romuald Członkowski
8025d31e63 Merge PR #67: Fix Claude Code configuration key in documentation
Fixes the MCP configuration key from 'servers' to 'mcpServers' as expected by Claude Code.
2025-07-17 08:56:00 +02:00
Iván Velasteguí
3279283aaf Update CLAUDE_CODE_SETUP.md
fix .mcp.json file for Claude code setup Project configuration
2025-07-17 00:40:34 -05:00
Romuald Członkowski
df03d425e5 Merge pull request #62 from naXa777/patch-1
Update the deep link in response returned by n8n_diagnostic tool
2025-07-17 01:39:29 +02:00
czlonkowski
cd3233cabe docs: add Railway one-click deployment option with setup guide and images 2025-07-17 01:34:27 +02:00
czlonkowski
637e7f978b feat: optimize Railway Docker image to use runtime-only dependencies
- Switch from package.json to package.runtime.json in runtime stage
- Reduces image size by 82% (from ~1.5GB to ~280MB)
- 10x faster builds (1-2 minutes vs 12 minutes)
- No functional changes - uses pre-built database from git
- Aligns Railway image with main Dockerfile optimization

This dramatically improves Railway deployment performance while
maintaining full functionality.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 01:13:17 +02:00
Romuald Członkowski
1da2d4fce2 Merge pull request #63 from czlonkowski/kimbo128/main
Merging with admin privileges - Railway deployment support
2025-07-17 01:03:34 +02:00
czlonkowski
f1e287e031 fix: remove branch prefix from SHA tag to avoid invalid Docker tag format 2025-07-17 00:57:51 +02:00
czlonkowski
b111eb64d6 Merge branch 'main' into kimbo128/main - resolve conflicts 2025-07-17 00:55:50 +02:00
czlonkowski
8a15961995 feat: add Railway deployment support with CI/CD integration
- Add Railway-specific Docker image build to CI/CD workflow
  - Builds n8n-mcp-railway image alongside standard image
  - Railway image optimized for AMD64 architecture
  - Automatically published to ghcr.io on main branch pushes

- Create comprehensive Railway deployment documentation
  - Step-by-step deployment guide with security best practices
  - Claude Desktop connection instructions via mcp-remote
  - Troubleshooting guide for common issues
  - Architecture details and single-instance design explanation

- Update README with Railway documentation link
  - Removed inline Railway content to keep README focused
  - Added link to dedicated Railway deployment guide

This enables zero-configuration cloud deployment of n8n-mcp
with automatic HTTPS, global access, and built-in monitoring.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-17 00:46:14 +02:00
Pavel
6a878d751d Update the deep link in response returned by n8n_diagnostic tool 2025-07-17 00:20:38 +02:00
czlonkowski
0155e4555c feat: add Railway deployment with zero-config setup 2025-07-16 17:41:26 +02:00
moonwalk
50d63a883b Update README.md 2025-07-16 14:10:33 +02:00
moonwalk
c089ee60d8 Update Dockerfile.railway 2025-07-16 13:56:14 +02:00
moonwalk
a6ccdd08b6 Update railway.json 2025-07-16 13:55:55 +02:00
moonwalk
534efddedf Update railway.json 2025-07-16 13:51:38 +02:00
moonwalk
9a5a10194b Update Dockerfile 2025-07-16 13:47:06 +02:00
moonwalk
45a0e755b7 Update Dockerfile 2025-07-16 13:44:48 +02:00
moonwalk
012a54dde2 Rename __Dockerfile to Dockerfile 2025-07-16 13:41:17 +02:00
moonwalk
0bb9d8bd01 Rename Dockerfile to __Dockerfile 2025-07-16 13:38:38 +02:00
moonwalk
2c18df5b8d Rename Dockerfile.original to Dockerfile 2025-07-16 13:34:04 +02:00
moonwalk
3b06ba91dd Delete Dockerfile 2025-07-16 13:33:54 +02:00
moonwalk
59843c7271 Create Dockerfile 2025-07-16 13:32:35 +02:00
moonwalk
1f269cf7e2 Rename Dockerfile to Dockerfile.original 2025-07-16 13:32:17 +02:00
moonwalk
614cfccd40 Rename _Dockerfile to Dockerfile
back
2025-07-16 13:31:21 +02:00