Root cause analysis and fixes:
1. **MCP_MODE environment variable tests**
- Issue: Tests were checking env vars after exec process replacement
- Fix: Test actual HTTP server behavior instead of env vars
- Changed tests to verify health endpoint responds in HTTP mode
2. **NODE_DB_PATH configuration tests**
- Issue: Tests expected env var output but got initialization logs
- Fix: Check process environment via /proc/1/environ
- Added proper async handling for container startup
3. **Permission handling tests**
- Issue: BusyBox sleep syntax and timing race conditions
- Fix: Use detached containers with proper wait times
- Check permissions after entrypoint completes
4. **Implementation improvements**
- Export NODE_DB_PATH in entrypoint for visibility
- Preserve env vars when switching to nodejs user
- Add debug output option in n8n-mcp wrapper
- Handle NODE_DB_PATH case preservation in parse-config.js
5. **Test infrastructure**
- Created test-helpers.ts with proper async utilities
- Use health checks instead of arbitrary sleep times
- Test actual functionality rather than implementation details
These changes ensure tests verify the actual behavior (server running,
health endpoint responding) rather than checking internal implementation
details that aren't accessible after process replacement.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Security Fixes:
- Add command injection prevention in n8n-mcp wrapper with whitelist validation
- Fix race condition in database initialization with proper lock directory creation
- Add flock availability check with fallback behavior
- Implement comprehensive input sanitization in parse-config.js
Improvements:
- Add debug logging support to parse-config.js (DEBUG_CONFIG=true)
- Improve test cleanup error handling with proper error tracking
- Increase integration test timeouts for CI compatibility
- Update test assertions to check environment variables instead of processes
All critical security vulnerabilities identified by code review have been addressed.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit adds comprehensive support for JSON configuration files in Docker containers,
addressing the issue where the Docker image fails to start in server mode and ignores
configuration files.
## Changes
### Docker Configuration Support
- Added parse-config.js to safely parse JSON configs and export as shell variables
- Implemented secure shell quoting to prevent command injection
- Added dangerous environment variable blocking for security
- Support for all JSON data types with proper edge case handling
### Docker Server Mode Fix
- Added support for "n8n-mcp serve" command in entrypoint
- Properly transforms serve command to HTTP mode
- Fixed missing n8n-mcp binary issue in Docker image
### Security Enhancements
- POSIX-compliant shell quoting without eval
- Blocked dangerous variables (PATH, LD_PRELOAD, etc.)
- Sanitized configuration keys to prevent invalid shell variables
- Protection against shell metacharacters in values
### Testing
- Added 53 comprehensive tests for Docker configuration
- Unit tests for parsing, security, and edge cases
- Integration tests for Docker entrypoint behavior
- Security-focused tests for injection prevention
### Documentation
- Updated Docker README with config file mounting examples
- Enhanced troubleshooting guide with config file issues
- Added version bump to 2.8.2
### Additional Files
- Included deployment-engineer and technical-researcher agent files
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
