
ziv-daniel/node-red-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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.
🔍 Semantic Search
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
- Available Tools
- Read-Only Mode
- Resources
- Prompts
- Agent Skill
- Connecting
- Node-RED Authentication
- Environment Variables
⚡ 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
Установка
docker run -e NODERED_URL=http://your-nodered:1880 \Конфигурация
{
"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"
}
}
}
}