mibo-testing

n8n community node for Mibo Testing - Capture and send workflow traces for semantic and procedural testing

Package Information

Downloads: 0 weekly / 21 monthly
Latest Version: 0.2.1
Author: Mibo Testing

Documentation

n8n-nodes-mibo-testing

n8n community node for Mibo Testing - a platform for semantic and procedural testing of AI workflows.

npm

Features

  • Auto-detect Workflow Nodes: Automatically discover all nodes in your workflow via the n8n API, or fall back to the "Get Workflow" node
  • Smart Node Filtering: Filter captured nodes by preset (All, AI Only, HTTP/Webhook, Exclude Utility) or pick specific nodes
  • Optimized Trace Format: Compact payloads with node type information for server-side AI auto-detection
  • Automatic Compression: Payloads larger than 5MB are gzip-compressed before sending
  • Request ID Correlation: Auto-detects x-request-id from webhook headers for active testing
  • Passthrough Design: Captures traces transparently without modifying your workflow data

Installation

Community Nodes (Recommended)

  1. Go to Settings > Community Nodes in your n8n instance
  2. Search for @mibo-ai/n8n-nodes-mibo-testing
  3. Click Install

Manual Installation

npm install @mibo-ai/n8n-nodes-mibo-testing

Then restart your n8n instance.

Configuration

Credentials

Create a new credential of type Mibo Testing API with the following fields:

Field Required Description
API Key Yes Your Mibo Testing API key. Find it in your Mibo Testing dashboard under Settings > API Keys.
n8n API Key No Your n8n instance API key. Enables automatic workflow node detection without needing a separate "Get Workflow" node. To create one: open n8n, go to Settings > API, and click Create an API Key. The key only needs the workflow:read scope.
n8n Base URL No The URL where your n8n instance is running. Defaults to http://localhost:5678 which works for most setups since the node runs inside n8n itself. Change only for n8n Cloud or custom deployments.

Node Setup

Add the Mibo Testing node at the end of your workflow (or wherever you want to capture the trace).

Auto-detect Mode (Recommended)

Enable Auto-detect Workflow Nodes to automatically discover all nodes in your workflow.

  • If you configured the n8n API Key and n8n Base URL in the credentials, it works automatically with no extra setup.
  • If you didn't configure n8n API credentials, connect an n8n "Get Workflow" node before this one as a fallback.
Auto-detect with n8n API credentials:
[Trigger] --> [Your Nodes] --> [Mibo Testing]

Fallback without n8n API credentials:
[Trigger] --> [Your Nodes] --> [Get Workflow] --> [Mibo Testing]

Node Filter options when using Auto-detect:

Filter What it captures
All Nodes Every node in the workflow (excluding internal/utility types)
AI Nodes Only Only nodes with "AI" in their name
HTTP/Webhook Only Only HTTP Request and Webhook nodes
Exclude Utility Nodes Everything except Set, If, Merge, and Switch
Custom You specify exact node names, separated by commas

Manual Mode

Leave Auto-detect Workflow Nodes off and enter node names separated by commas in the Target Nodes field.

[Trigger] --> [Your Nodes] --> [Mibo Testing]
                                    ^
                        Target Nodes: "Webhook, AI Agent, HTTP Request"

Other Parameters

Parameter Description
Request ID The x-request-id for correlating this trace with test executions. Auto-detected from webhook headers if not provided.
Platform ID Your platform UUID in Mibo Testing. If not provided, the API resolves it from your API key restrictions.
Include Metadata Add environment, version, and custom fields to the trace.

Advanced Options

Option Default Description
Timeout (Seconds) 30 Maximum time to wait for the Mibo Testing server to respond.

Output

The node passes through all input data unchanged, adding a _miboTrace object to each item:

{
  "original_field": "preserved",
  "_miboTrace": {
    "sent": true,
    "traceId": "abc-123",
    "platformId": "550e8400-...",
    "requestId": "req-456",
    "timestamp": "2026-03-08T10:30:00.000Z",
    "nodesCollected": 3,
    "targetNodes": ["Webhook", "AI Agent", "HTTP Request"],
    "payloadSize": "12.5 KB"
  }
}

Development

Prerequisites

  • Node.js >= 20.0.0
  • pnpm >= 10.0.0
  • Docker (optional, for Docker-based development)

Setup

git clone https://github.com/mibo-ai/mibo-testing-n8n-node.git
cd mibo-testing-n8n-node
pnpm install

Development Options

Option 1: Local Development (Recommended)

Requires n8n installed globally:

# Install n8n globally (one time)
pnpm add -g n8n

# Build and link the node
pnpm run dev:link

# Link to your n8n installation (one time)
cd ~/.n8n && npm link @mibo-ai/n8n-nodes-mibo-testing

# Start development mode (builds, watches, restarts n8n on changes)
pnpm run dev

Open http://localhost:5678 to access n8n.

Option 2: Docker Development

No global n8n installation needed:

pnpm run dev:docker

Builds the project, starts n8n in Docker, and watches for file changes. Reload your workflow in n8n to pick up changes.

Open http://localhost:5678 to access n8n.

Available Commands

Command Description
pnpm run build Compile TypeScript to dist/
pnpm run dev Local development with hot reload
pnpm run dev:docker Docker development with hot reload
pnpm run dev:link Build and link for local n8n
pnpm test Run unit tests
pnpm test:watch Run tests in watch mode
pnpm run check Run Biome linter and formatter
pnpm run check:fix Auto-fix linting and formatting issues
pnpm run docker:build Build production Docker image

Makefile Shortcuts

make help         # Show all commands
make dev          # Same as pnpm run dev
make dev-docker   # Same as pnpm run dev:docker
make build        # Same as pnpm run build
make check        # Same as pnpm run check
make clean        # Remove dist/ and node_modules/

Project Structure

├── nodes/MiboTesting/
│   ├── MiboTesting.node.ts       # Main node implementation
│   ├── builders.ts               # Trace payload builders
│   ├── constants.ts              # Configuration constants
│   ├── mibo-client.ts            # HTTP client for Mibo API
│   ├── types.ts                  # TypeScript interfaces
│   ├── utils.ts                  # Utility functions
│   └── mibo-testing.svg          # Node icon
├── credentials/
│   └── MiboTestingApi.credentials.ts
├── tests/
│   ├── node.test.ts              # Node execution tests
│   ├── builders.test.ts          # Payload builder tests
│   ├── mibo-client.test.ts       # HTTP client tests
│   └── utils.test.ts             # Utility function tests
├── scripts/
│   ├── dev.mjs                   # Local dev script
│   ├── dev-docker.mjs            # Docker dev script
│   └── copy-icons.mjs            # Icon copy utility
├── docs/                         # Internal documentation
├── dist/                         # Compiled output (generated)
├── docker-compose.dev.yml        # Docker development config
├── Dockerfile                    # Production Docker image
└── Makefile                      # Convenience commands

License

GPL-3.0-or-later

Discussion