Skip to content

Releases: salacoste/mcp-n8n-workflow-builder

v0.9.3 - Security Fix & Documentation Enhancement

27 Dec 16:47

Choose a tag to compare

🔒 Security Fix Release

CRITICAL: This release addresses a security vulnerability where sensitive log files were inadvertently published to npm in versions 0.9.1 and 0.9.2.

🛡️ Security Fixes

  • Prevented log files from npm packages - Added *.log to .npmignore
  • Removed sensitive data exposure - Deleted server.log containing API keys
  • Unpublished vulnerable versions - Removed v0.9.1 and v0.9.2 from npm registry

⚠️ ACTION REQUIRED: If you installed v0.9.1 or v0.9.2, please rotate your n8n API key immediately.


📦 Package Improvements

  • Package size: 653.2 KB (↓ 45.8 KB from v0.9.2)
  • File count: 200 files (↓ 1 file)
  • Clean build: No sensitive data included

📚 Documentation Enhancements

  • Comprehensive README overhaul - Modern structure with 11 new sections
  • Professional badges - npm version, downloads, license, and docs
  • SEO optimization - Enhanced GitHub repository description and topics
  • GitHub Issues updated - Added documentation links to 5 issues

📥 Installation

NPM (Recommended)

npm install -g @kernel.salacoste/n8n-workflow-builder@latest

Verify Installation

npx @kernel.salacoste/n8n-workflow-builder --version
# Should output: 0.9.3

---
🚀 Quick Start

1. Configure Multi-Instance

Create .config.json:

{
  "environments": {
    "production": {
      "n8n_host": "https://n8n.example.com",
      "n8n_api_key": "your_production_api_key"
    },
    "development": {
      "n8n_host": "http://localhost:5678",
      "n8n_api_key": "your_dev_api_key"
    }
  },
  "defaultEnv": "development"
}

2. Integrate with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["@kernel.salacoste/n8n-workflow-builder"]
    }
  }
}

Restart Claude Desktop and start building workflows! 🎉

---
📖 Documentation

- 🌐 https://salacoste.github.io/mcp-n8n-workflow-builder/
- 🚀 https://salacoste.github.io/mcp-n8n-workflow-builder/getting-started/quick-start/first-workflow/
- 🛠️ https://salacoste.github.io/mcp-n8n-workflow-builder/api/overview/
- 🏗️ https://salacoste.github.io/mcp-n8n-workflow-builder/multi-instance/overview/
- 🐛 https://salacoste.github.io/mcp-n8n-workflow-builder/troubleshooting/faq/

---
✨ What's Included

17 MCP Tools

- 8 Workflow Tools - Create, update, delete, activate, execute workflows
- 4 Execution Tools - Monitor, retry, analyze workflow runs
- 5 Tag Tools - Organize and categorize workflows
- 6 Credential Tools - Secure credential lifecycle management

Key Features

- 🤖 AI-Powered - Build workflows through natural language with Claude AI
- 🌍 Multi-Instance - Manage dev, staging, and production environments
- 🔒 Secure - Built-in credential protection and API key encryption
- 📚 Documented - 38+ documentation pages with guides and examples

---
🔄 Upgrade from Previous Versions

From v0.9.0 → v0.9.3

npm uninstall -g @kernel.salacoste/n8n-workflow-builder
npm install -g @kernel.salacoste/n8n-workflow-builder@latest

Breaking Changes: None ✅

New Features:
- Enhanced security with log file exclusion
- Improved README with modern structure
- SEO-optimized repository metadata

Migration Notes

No migration required. This is a security patch release with documentation improvements.

---
🐛 Known Issues

None at this time.

Report issues at: https://github.com/salacoste/mcp-n8n-workflow-builder/issues

---
🙏 Acknowledgments

- Security researchers who helped identify the log file exposure issue
- Early adopters providing valuable feedback
- Contributors improving documentation and code quality

---
📊 Release Stats

- Commits: 5
- Files Changed: 4
- Lines Added: 400+
- Lines Removed: 860+
- Contributors: 1
- Time to Release: 2 hours

---
🔗 Links

- 📦 npm Package: https://www.npmjs.com/package/@kernel.salacoste/n8n-workflow-builder
- 📚 Documentation: https://salacoste.github.io/mcp-n8n-workflow-builder/
- 💬 Discussions: https://github.com/salacoste/mcp-n8n-workflow-builder/discussions
- 🐛 Issues: https://github.com/salacoste/mcp-n8n-workflow-builder/issues

---
Full Changelog: https://github.com/salacoste/mcp-n8n-workflow-builder/compare/v0.9.0...v0.9.3