ynode

Open-Source Nodes Workflow Automation Platform.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio iamyureka-ynode node packages/ynode-server/src/server.js \
  --env PORT="3001" \
  --env ENCRYPTION_KEY="<your-encryption-key>"

How to use

ynode is a visual workflow automation platform with a Node.js backend and a React frontend. The server side (ynode-server) exposes APIs and WebSocket endpoints that power the node-based editor and runtime, enabling you to run, test, and orchestrate custom nodes within your own environment. Use the included CLI tooling to scaffold or validate custom nodes, and connect your frontend editor (ynode-app) to the backend to design, execute, and monitor automated workflows in real time. Typical usage involves starting the backend API (ynode-server) and the frontend UI (ynode-app), then creating and wiring nodes in the visual editor to perform tasks such as data transformation, API calls, and secure credential handling via the built-in encryption features.

How to install

Prerequisites:

Node.js 18 or higher
pnpm package manager

Clone the repository

git clone https://github.com/iamyureka/ynode.git
cd ynode

Install dependencies

pnpm install

Build the core library (shared types and definitions)

pnpm --filter @ynode/core build

Install and run the backend and frontend development environments (optional for first run)

pnpm --filter ynode-server dev &
pnpm --filter ynode-app dev &

Open the application in your browser (default URLs depend on your setup)

App: http://localhost:5173
API: http://localhost:3001

Additional notes

The server exposes a WebSocket and REST API for real-time editing and execution of nodes.
Environment variables you may want to configure:
- PORT: API port (default 3001 for the backend)
- ENCRYPTION_KEY: key used for credential encryption; replace with a secure value in production
- Any other config your deployment requires (e.g., database connection strings)
If you modify or scaffold custom nodes, use the provided CLI under packages/ynode-cli; for example, scaffold a new node with: pnpm --filter ynode-cli create my-custom-node
Ensure network access between the frontend (ynode-app) and backend (ynode-server) to enable the visual editor and live execution.
This project is designed as a monorepo (pnpm workspaces); run commands with the appropriate --filter to target specific packages.

Related MCP Servers

mcp-atlassian

MCP server connecting AI assistants with Jira & Confluence for smart project management.

mcp -js

MCP server that exposes YepCode processes as callable tools for AI platforms. Securely connect AI assistants to your YepCode workflows, APIs, and automations.

architect

A powerful, self-extending MCP server for dynamic AI tool orchestration. Features sandboxed JS execution, capability-based security, automated rate limiting, marketplace integration, and a built-in monitoring dashboard. Built for the Model Context Protocol (MCP).

mcp-agent

Lightweight, focused utilities to manage connections and execute MCP tools with minimal integration effort. Use it to directly call tools or build simple agents within your current architecture.

gridctl

🧪 Local Stack for testing Agents

tally

MCP server for Tally.so - manage forms through AI with natural language commands and safety-first bulk operations