Commit Graph

294 Commits

Author SHA1 Message Date
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
moonwalk
536effacd5 Rename Dockerfile to _Dockerfile
only for testing
2025-07-16 13:30:20 +02:00
moonwalk
c0d65cc9f4 Update Dockerfile.railway
added echo
2025-07-16 13:22:24 +02:00
moonwalk
55dfedd8a6 Update Dockerfile.railway
updated not working file
2025-07-16 13:16:02 +02:00
moonwalk
9e43836f31 Update Dockerfile.railway
added entrypoint
2025-07-16 13:14:02 +02:00
moonwalk
498e88e7ae Update railway.json
added mount
2025-07-16 13:04:03 +02:00
moonwalk
3efd28d3ff Update Dockerfile
rolled back to original
2025-07-16 13:03:11 +02:00
moonwalk
4366cde528 Update Dockerfile 2025-07-16 11:37:32 +02:00
czlonkowski
4ec3b94756 docs: revert Railway deployment documentation
Rolled back README.md to remove Railway deployment instructions while keeping the codebase changes intact. This addresses any confusion about deployment methods without breaking existing Railway deployments.
2025-07-16 11:09:47 +02:00
czlonkowski
5f140545d5 fix railway 2 2025-07-16 10:46:54 +02:00
czlonkowski
c1781f4265 Fix railway button 2025-07-16 10:45:42 +02:00
moonwalk
b1cd1f621b Update README.md 2025-07-16 10:42:36 +02:00
moonwalk
1b7221ccfd Update README.md
Botton fixed
2025-07-16 10:40:52 +02:00
czlonkowski
3fb3e015ba docs: add Railway deployment documentation (implements PR #53 review feedback)
- Add Railway as Option 4 in Quick Start section per review request
- Include brief explanation of Railway platform
- Add deploy button with proper placement
- Document setup instructions and environment variables
- Add AUTH_TOKEN configuration note
- Include database availability requirements note
- Configure Claude Desktop integration via mcp-remote

This commit implements the documentation requirements from PR #53 review,
completing the Railway deployment feature.
2025-07-16 10:31:49 +02:00