n8n Express Microservice Node

A custom n8n node that allows users to visually configure and deploy Express.js microservices within n8n workflows.

Features

• 🚀 Dynamic Express Server: Create HTTP endpoints on-the-fly
• 🎛️ Visual Configuration: Configure routes, methods, and responses through n8n UI
• 🔧 Port Management: Automatic port availability checking
• 📊 Multiple HTTP Methods: Support for GET, POST, PUT, PATCH, DELETE
• 🔒 Security: Built-in authentication options (Basic Auth, API Key)
• 🔄 n8n Integration: Seamless workflow integration with output mapping

Installation

1. Clone the repository

   git clone <repository-url>
   cd n8n-express-microservice-node
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

4. Install in n8n

   • Copy the built node to your n8n custom nodes directory
   • Restart n8n to load the new node

Development

Build

npm run build

Watch mode for development

npm run dev

Run tests

npm test

Lint code

npm run lint

Project Structure

├── nodes/
│   └── ExpressServerNode/
│       ├── ExpressServerNode.node.ts    # Main node implementation
│       └── ExpressServerNode.node.json  # Node metadata
├── test/                                # Test files
├── dist/                               # Built files
├── package.json                        # Dependencies and scripts
├── tsconfig.json                       # TypeScript configuration
└── README.md                          # This file

Usage

1. Add the node to your n8n workflow
2. Configure the port where the Express server should run
3. Define HTTP methods with their routes and responses
4. Activate the workflow to start the Express server
5. Make HTTP requests to the configured endpoints

Example Configuration

{
  "port": 3001,
  "methods": [
    {
      "name": "/health",
      "httpMethod": "GET",
      "successCode": 200,
      "failureCode": 500,
      "contentType": "application/json",
      "outputMapping": "{\"status\":\"ok\"}"
    }
  ]
}

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

License

MIT