Nr MCP server
io.github.Texan-NXTassist/nr-mcp·v1.2.2·1 starsMCP server for Node-RED — safe deploy, optimistic locking, smart search, 13 tools
1 stars29 downloads/wk
Reviews
Write oneNobody has reviewed Nr yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Nr tools (13, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
nr_create_nodeswrite actionCreate one or more new nodes/groups in a single deploy. Each node dict must include 'id', 'type', and 'z' (target tab ID). Groups need 'type': 'group'. Config nodes (e.g. ha-entity-config) use 'z': '' for global scope.
nr_delete_nodeswrite actionDelete one or more nodes by ID. Also cleans up references: removes deleted IDs from group.nodes arrays and from other nodes' wires arrays.
nr_get_debug_outputRead debug output from flow context. Use when a flow has a catch node that stores errors/debug data to flow context. Pass key=null to list all context keys. Trigger flow with nr_inject first, then read this.
nr_get_flowGet a single Node-RED tab with all its nodes and groups. Accepts tab name (case-insensitive) or tab ID.
nr_get_flow_contextRead Node-RED flow context variables. Pass key=null to list all keys, or a specific key to get its value.
nr_get_flow_summaryQuick overview of all Node-RED tabs with node counts and groups.
nr_get_function_codeExtract full JavaScript code from a Node-RED function node.
nr_get_installed_modulesList installed Node-RED modules and their node types. Optionally filter by module name or node type containing `query` string. Returns module name, version, and list of node types provided.
nr_get_node_configGet full node configuration including wires, upstream/downstream connections, and group membership.
nr_injectTrigger an inject node to fire immediately. Use nr_search_nodes to find inject nodes first. The node must be of type 'inject'.
nr_install_moduleInstall a new Node-RED module (npm package) from the registry. Use nr_get_installed_modules to check what's already installed first. Installation may take 30-60 seconds.
nr_safe_deploywrite actionDeploy changes to a Node-RED node with optimistic locking. Uses correct GET\u2192POST pattern (never PUT). Preserves tab order.
nr_search_nodesSearch Node-RED nodes by name, type, or function code content. Searches in: name, type, func, template, action fields.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan6 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 186 days ago4/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Nr compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 66/100
- higher than 23% of 1,119 Developer tools servers
- Tools
- 13
- the typical Developer tools server has 7
- Tools that change things
- 23%
- typical: 5%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 855 Developer tools servers
- Downloads a week
- 29
- more than 13% of 436 Developer tools servers with a package
What its tools let an agent do: 10 read · 3 change
Install Nr in Claude Code, Cursor or VS Code
claude mcp add nr-mcp -- uvx nr-mcp
What the publisher says
From the Nr repository's README, as published. We do not edit it. Read it on GitHub
nr-mcp
<!-- mcp-name: io.github.Texan-NXTassist/nr-mcp -->
A Model Context Protocol (MCP) server that lets AI assistants interact with Node-RED — read flows, search nodes, edit function code, deploy changes safely, and manage modules.
Built to solve real problems: the existing Node-RED MCP implementations use PUT /flow/:id which reorders your tabs. nr-mcp uses the correct GET → POST /flows pattern with optimistic locking, so your tab order is always preserved.
Features
13 tools for complete Node-RED flow management:
Why not just use the existing MCP servers?
- Tab reorder bug: Other implementations use PUT /flow/:id which silently reorders your tabs in Node-RED. nr-mcp uses the correct GET → POST /flows full-deploy pattern.
- Optimistic locking: Every deploy checks the rev field. If someone else deployed between your read and write, you get a clear conflict error instead of silent data loss.
- Smart search: Search across node names, types, function code, templates, and actions in one call.
- Production-tested: Built and used daily for managing complex Node-RED installations (home automation, IoT, energy management).
Installation
Prerequisites
- Python 3.11+
- uv (recommended) or pip
- Node-RED instance with Admin API enabled
Install from PyPI
pip install nr-mcpInstall with uv (recommended)
uv tool install nr-mcpOr from source:
git clone https://github.com/Texan-NXTassist/nr-mcp.git
cd nr-mcp
uv tool install .This creates the nr-mcp command in ~/.local/bin/.
Configuration
Environment variables
\* At least one auth method is recommended. Auth is checked in order: token → basic auth → no auth.
Claude Desktop
Add to your claudedesktopconfig.json:
{
"mcpServers": {
"nr-mcp": {
"command": "nr-mcp",
"env": {
"NR_URL": "http://localhost:1880",
"NR_USER": "admin",
"NR_PASS": "your-password"
}
}
}
}Tip: If you get a "working directory" error, create a wrapper script:
bash
#!/bin/bash
cd /tmp
exec nr-mcp "$@"
Then point command to the wrapper path.
Cursor / VS Code
Add to your MCP settings (.cursor/mcp.json or VS Code equivalent):
{
"mcpServers": {
"nr-mcp": {
"command": "nr-mcp",
"env": {
"NR_URL": "http://localhost:1880",
"NR_TOKEN": "your-access-token"
}
}
}
}Usage examples
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Nr: common questions
- Is Nr MCP server safe?
- With care: it is graded C, so read the findings first (66/100). Read the Nr safety report
- How do I install Nr?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Nr need an API key?
- Yes. The registry entry asks for
NR_TOKEN,NR_PASS. - Is Nr maintained?
- The last commit was 224 days ago (2026-03-25). The latest release is v1.2.2.
- What can I use instead of Nr?
- Servers from other publishers that do the same job: walkerOS Flow MCP server, Omnara MCP server and Metaplex Agent Registry MCP server.
- How does Nr compare with other Developer tools MCP servers?
- safety score 66/100 (higher than 23% of 1,119 Developer tools servers); tools 13 (the typical Developer tools server has 7); tools that change things 23% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Nr
Same job from other publishers: the closest match first, then the best rated.
walkerOS FlowBuild, validate, simulate, and deploy walkerOS event pipelinesnot reviewedEstablishedB- OmnaraDeploy durable AI agents with Omnara, an open-source managed-agent platform.not reviewedEstablishedA
- Metaplex Agent RegistryDeploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks.not reviewedEstablishedB
Aiven MCPProvision PostgreSQL, manage Apache Kafka, and deploy apps with Aiven - all from your AI assistant.not reviewedEstablishedA- ShipStaticDeploy static websites, landing pages, and prototypes instantly. Free, no account needed.not reviewedEstablishedA