ZD

ziv-daniel/node-red-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 7 forks Качество 71 Тренд 34

MCP Node-RED Integration Server - Real-time Node-RED management via Model Context Protocol

Обзор

A modern, production-ready Model Context Protocol (MCP) server for Node-RED integration. Full CRUD for flows, context variables, modules, and diagnostics — plus semantic search and real-time error detection. Built-in prompt templates: debug_flow, explain_automation, audit_security, document_flow. Browse Node-RED state as structured resources: nodered://flows, nodered://subflows, nodered://nodes, nodered://context/global, flow:// , system://runtime. Embeddings-based search across flows and nodes via semantic_search_flows. Finds by meaning, not just keywords. The server asks clarifying questions mid-call when required parameters are missing (MCP SDK 1.24+ elicitation). get_node_errors connects to Node-RED's WebSocket /comms endpoint to detect nodes in error/warning state in real time. - 22.23.4+, 24.22.1+, or 26.12.1+ (within those supported major lines; LTS recommended). These security floors address CVE-2026-111497. Node 23/25 and older EOL lines are not supported. - 4.

README

Показан фрагмент оригинального README. Открыть оригинал.

🚀 MCP Node-RED Server

A modern, production-ready Model Context Protocol (MCP) server for Node-RED integration.

🌟 Features

🔧 20 MCP Tools

Full CRUD for flows, context variables, modules, and diagnostics — plus semantic search and real-time error detection.

📚 Prompts Library

Built-in prompt templates: debug_flow, explain_automation, audit_security, document_flow.

📦 MCP Resources

Browse Node-RED state as structured resources: nodered://flows, nodered://subflows, nodered://nodes, nodered://context/global, flow://, system://runtime.

Embeddings-based search across flows and nodes via semantic_search_flows. Finds by meaning, not just keywords.

🧠 Elicitation

The server asks clarifying questions mid-call when required parameters are missing (MCP SDK 1.24+ elicitation).

🚨 Real-time Error Detection

get_node_errors connects to Node-RED’s WebSocket /comms endpoint to detect nodes in error/warning state in real time.

📋 Table of Contents

⚡ Quick Start

Prerequisites

  • Node.js 22.23.4+, 24.22.1+, or 26.12.1+ (within those supported major lines; LTS recommended). These security floors address CVE-2026-111497. Node 23/25 and older EOL lines are not supported.
  • Yarn 4.x (managed via Corepack; on Node 25+ install it first with npm install -g corepack)
  • Docker (optional, for containerized setup)

After deploying, check node --version in the running service: the engines field and major-version-only builders (such as Nixpacks) do not guarantee a patched runtime.

Native Installation

git clone https://github.com/ziv-daniel/node-red-mcp.git
cd node-red-mcp
yarn install
yarn build

Docker

docker run -e NODERED_URL=http://your-nodered:1880 \
           -e NODERED_USERNAME=admin \
           -e NODERED_PASSWORD=password \
           -e MCP_TRANSPORT=http \
           -p 3000:3000 \
           ghcr.io/ziv-daniel/node-red-mcp:latest

🔧 Available MCP Tools

Flow Management

Открыть полный README на GitHub

Установка

docker run -e NODERED_URL=http://your-nodered:1880 \
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "nodered": { "command": "node", "args": ["path/to/node-red-mcp/dist/index.mjs"], "env": { "MCP_TRANSPORT": "stdio", "NODERED_URL": "https://your-nodered-instance.com", "NODERED_USERNAME": "admin", "NODERED_PASSWORD": "password" } } } }