Node-RED MCP Server

MCP (Model Context Protocol) server for Node-RED integration with Claude Code.

Fork of ziv-daniel/node-red-mcp - simplified for quick setup.

Quick Start

git clone https://github.com/Sherlock-GmbH/node-red-mcp.git
cd node-red-mcp
pnpm install
pnpm build

Configure Claude Code

claude mcp add nodered -e NODERED_URL=http://localhost:1880 -- node /path/to/node-red-mcp/dist/index.mjs

Or manually in ~/.claude.json:

{
  "mcpServers": {
    "nodered": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/node-red-mcp/dist/index.mjs"],
      "env": {
        "NODERED_URL": "http://localhost:1880"
      }
    }
  }
}

Prerequisites

• Node.js 22+
• pnpm
• Node-RED running (default: http://localhost:1880)

Available MCP Tools

Tool	Description
get_flows	List all flows
get_flow	Read single flow
create_flow	Create new flow
update_flow	Update flow
enable_flow	Enable flow
disable_flow	Disable flow
search_modules	Search NPM modules
install_module	Install module

Environment Variables

Variable	Default	Description
NODERED_URL	http://localhost:1880	Node-RED URL
NODERED_USERNAME	-	Optional: Basic Auth user
NODERED_PASSWORD	-	Optional: Basic Auth password

Development

pnpm dev        # Development with hot reload
pnpm build      # Production build
pnpm test       # Run tests
pnpm lint       # Linting

Full Setup (Original)

This fork is simplified for quick onboarding. The original repo offers additionally:

• Docker Compose with full stack:
  • PostgreSQL (persistence)
  • Redis (caching, rate limiting)
  • Prometheus + Grafana (monitoring)
  • Jaeger (distributed tracing)
  • Traefik (reverse proxy)
• Production features: JWT Auth, Rate Limiting, CORS
• CI/CD workflows: GitHub Actions, CodeQL Security Scanning

Use the original for production deployments or advanced observability.

License

MIT - see LICENSE

Credits

Based on ziv-daniel/node-red-mcp