mcp-node-red 1.0.0 → 1.1.0

package/dist/tools/set-debug-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-debug-state.js","sourceRoot":"","sources":["../../src/tools/set-debug-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,IAAa;IACtE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE9D,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aAClF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-flow-state.d.ts

@@ -0,0 +1,8 @@
+import type { NodeRedClient } from '../client.js';
+export declare function setFlowState(client: NodeRedClient, args: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=set-flow-state.d.ts.map

package/dist/tools/set-flow-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-flow-state.d.ts","sourceRoot":"","sources":["../../src/tools/set-flow-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO;;;;;GAWtE"}

package/dist/tools/set-flow-state.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+const SetFlowStateArgsSchema = z.object({
+    state: z.enum(['start', 'stop']),
+});
+export async function setFlowState(client, args) {
+    const parsed = SetFlowStateArgsSchema.parse(args);
+    const result = await client.setFlowState(parsed.state);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=set-flow-state.js.map

package/dist/tools/set-flow-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-flow-state.js","sourceRoot":"","sources":["../../src/tools/set-flow-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAqB,EAAE,IAAa;IACrE,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/set-node-module-state.d.ts

@@ -0,0 +1,8 @@
+import type { NodeRedClient } from '../client.js';
+export declare function setNodeModuleState(client: NodeRedClient, args: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=set-node-module-state.d.ts.map

package/dist/tools/set-node-module-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-node-module-state.d.ts","sourceRoot":"","sources":["../../src/tools/set-node-module-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO;;;;;GAW5E"}

package/dist/tools/set-node-module-state.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const SetNodeModuleStateArgsSchema = z.object({
+    module: z.string(),
+    enabled: z.boolean(),
+});
+export async function setNodeModuleState(client, args) {
+    const parsed = SetNodeModuleStateArgsSchema.parse(args);
+    const result = await client.setNodeModuleState(parsed.module, parsed.enabled);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=set-node-module-state.js.map

package/dist/tools/set-node-module-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-node-module-state.js","sourceRoot":"","sources":["../../src/tools/set-node-module-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAqB,EAAE,IAAa;IAC3E,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9E,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/trigger-inject.d.ts

@@ -0,0 +1,8 @@
+import type { NodeRedClient } from '../client.js';
+export declare function triggerInject(client: NodeRedClient, args: unknown): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=trigger-inject.d.ts.map

package/dist/tools/trigger-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-inject.d.ts","sourceRoot":"","sources":["../../src/tools/trigger-inject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO;;;;;GAavE"}

package/dist/tools/trigger-inject.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+const TriggerInjectArgsSchema = z.object({
+    nodeId: z.string(),
+});
+export async function triggerInject(client, args) {
+    const parsed = TriggerInjectArgsSchema.parse(args);
+    await client.triggerInject(parsed.nodeId);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ nodeId: parsed.nodeId, triggered: true }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=trigger-inject.js.map

package/dist/tools/trigger-inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-inject.js","sourceRoot":"","sources":["../../src/tools/trigger-inject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,IAAa;IACtE,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aAC1E;SACF;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-node-red",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Node-RED workflow management",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,8 @@
     "test:coverage": "vitest run --coverage",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
-    "format": "biome format --write ."
+    "format": "biome format --write .",
+    "prepare": "husky"
   },
   "keywords": [
     "mcp",
@@ -25,22 +26,38 @@
   ],
   "author": "",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fx/mcp-node-red"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
+    "dotenv": "^17.3.1",
     "undici": "^7.3.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
     "@types/node": "^22.10.5",
     "@vitest/coverage-v8": "^2.1.8",
-    "semantic-release": "^24.2.9",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.3",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "engines": {
     "node": ">=20"
+  },
+  "lint-staged": {
+    "*.{js,ts}": [
+      "biome format --write --files-ignore-unknown=true",
+      "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
+    ]
   }
 }

package/.github/workflows/ci.yml

@@ -1,37 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [20, 22]
-    steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
-      - run: npm run lint
-
-  coverage:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: 'npm'
-      - run: npm ci
-      - run: npm run build
-      - run: npm run test:coverage

package/.github/workflows/release.yml

@@ -1,30 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches: [main]
-
-permissions:
-  contents: write
-  issues: write
-  pull-requests: write
-  id-token: write
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-      - run: npm ci
-      - run: npm run build
-      - run: npm test
-      - run: npm run lint
-      - run: npx semantic-release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.mcp.json.example

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "node-red": {
-      "command": "node",
-      "args": ["/absolute/path/to/mcp-node-red/dist/index.js"],
-      "env": {
-        "NODE_RED_URL": "http://localhost:1880"
-      }
-    }
-  }
-}

package/.releaserc.json

@@ -1,17 +0,0 @@
-{
-  "branches": ["main"],
-  "plugins": [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
-    "@semantic-release/changelog",
-    "@semantic-release/npm",
-    "@semantic-release/github",
-    [
-      "@semantic-release/git",
-      {
-        "assets": ["package.json", "package-lock.json", "CHANGELOG.md"],
-        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
-      }
-    ]
-  ]
-}

package/CLAUDE.md

@@ -1,147 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-MCP (Model Context Protocol) server that provides Node-RED workflow management capabilities via stdio transport. Exposes 4 tools for AI agents to interact with Node-RED Admin API v2: get flows, create flow, update flow, and validate flow.
-
-## Commands
-
-```bash
-# Build (required after any code changes)
-npm run build
-
-# Development with auto-rebuild
-npm run dev
-
-# Run all tests
-npm test
-
-# Run tests with coverage
-npm run test:coverage
-
-# Run single test file
-npx vitest tests/client.test.ts
-
-# Lint
-npm run lint
-
-# Fix lint issues
-npm run lint:fix
-
-# Format code
-npm run format
-```
-
-## Architecture
-
-### Core Components
-
-**Server Layer** (`src/server.ts`):
-- Creates MCP server using `@modelcontextprotocol/sdk`
-- Reads config from env vars: `NODE_RED_URL` (required), `NODE_RED_TOKEN` (optional)
-- Registers 4 MCP tools with schemas (get_flows, create_flow, update_flow, validate_flow)
-- Routes tool calls to individual tool handlers
-- Catches errors and returns MCP-formatted error responses
-
-**HTTP Client** (`src/client.ts`):
-- `NodeRedClient` class wraps Node-RED Admin API v2
-- Handles two auth modes:
-  - Bearer token via `NODE_RED_TOKEN` env var
-  - Basic auth extracted from URL credentials (e.g., `http://user:pass@host:1880`)
-- Always sets `Node-RED-API-Version: v2` header
-- Uses `undici` for HTTP requests
-
-**Tools** (`src/tools/*.ts`):
-- Each tool is a standalone async function
-- Takes `NodeRedClient` instance and tool arguments
-- Returns MCP tool response format: `{ content: [{ type: 'text', text: '...' }] }`
-- `create-flow.ts` uses POST /flow to create new flows
-- `update-flow.ts` uses PUT /flow/:id to update individual flows safely
-
-**Schemas** (`src/schemas.ts`):
-- Zod schemas for validation
-- `NodeRedItemSchema` is a union of flows (type: "tab") and nodes (other types)
-- All items have `id` and `type`, flows also require `label`
-- Node references to parent flows via `z` property
-- `UpdateFlowRequestSchema` defines structure for PUT /flow/:id requests
-
-### Key Design Decisions
-
-**Stdio Transport**: Uses stdin/stdout for MCP communication, not HTTP. Server runs as child process.
-
-**API v2 with Optimistic Locking**: Uses `rev` field in responses to prevent conflicts.
-
-**Authentication Flexibility**: Supports both Bearer tokens (standalone Node-RED) and Basic auth (Home Assistant add-on).
-
-**JSON String Parameters**: MCP tool parameters receive flows as JSON strings, not objects. Tools parse and validate them.
-
-**Individual Flow Updates**: Uses PUT /flow/:id to update one flow at a time, preventing accidental destruction of other flows.
-
-## Node-RED Admin API v2
-
-**GET /flows**:
-- Returns all flows: `{rev: "...", flows: [...]}`
-
-**POST /flow**:
-- Creates a new flow
-- Request: `{id, label, nodes: [], configs: []}`
-- Response: 200 or 204 with `{id: "..."}` in body
-- Flow ID is optional - auto-generated if not provided
-
-**PUT /flow/:id**:
-- Updates a single flow by ID
-- Request: `{id, label, nodes: [], configs: []}`
-- Response: 204 with `{id: "..."}` in body
-- Only affects the specified flow, all other flows remain untouched
-
-## Testing
-
-Tests use vitest with mocked `undici` requests. Each component has dedicated test file:
-- `tests/client.test.ts` - HTTP client + auth modes
-- `tests/tools.test.ts` - Tool handlers
-- `tests/server.test.ts` - MCP server setup
-
-## CRITICAL: Flow Update Safety
-
-**Always use PUT /flow/:id for individual flow updates**
-
-The MCP server uses `PUT /flow/:id` which:
-- Updates ONLY the specified flow
-- Leaves all other flows completely untouched
-- No risk of destroying unrelated workflows
-- Simpler and safer than POST /flows
-
-**Flow update format**:
-```json
-{
-  "id": "flow-id",
-  "label": "Flow Name",
-  "nodes": [...],
-  "configs": [...]
-}
-```
-
-## CRITICAL: ALWAYS Use MCP Tools
-
-**NEVER bypass MCP tools to interact with Node-RED directly**
-
-- NEVER use `curl` to call Node-RED API directly
-- NEVER use Bash to make HTTP requests to Node-RED
-- ALWAYS use the MCP tools: `get_flows`, `create_flow`, `update_flow`, `validate_flow`
-
-The entire purpose of this MCP server is to provide safe, validated access to Node-RED through MCP tools. Bypassing them defeats the purpose and removes safety checks.
-
-If MCP tools appear to fail:
-1. Debug the MCP tool issue
-2. Fix the tool implementation
-3. Test the fix
-4. NEVER work around it with direct API calls
-
-## Configuration
-
-Required env var: `NODE_RED_URL`
-Optional env var: `NODE_RED_TOKEN`
-
-For Home Assistant add-on deployments, embed credentials in URL: `http://username:password@host:1880`