](https://www.npmjs.com/package/node-red-mcp-server) ](https://www.npmjs.com/package/node-red-mcp-server) ](https://github.com/karavaev-evgeniy/node-red-mcp-server/blob/main/LICENSE)
节点红色mcp服务器
用于Node-RED的模型上下文协议(MCP)服务器-允许语言模型(如Claude、GPT)通过标准化的API与Node-RED交互。
描述
node-red-mcp-server 在语言模型和Node-RED平台之间建立桥梁,提供通过MCP(模型上下文协议)管理流、节点和设置的工具。这使得语言模型能够以编程方式自动化和控制Node-RED流。
主要特点
- 通过MCP检索和更新节点RED流
- 管理选项卡和单个节点
- 按类型或属性搜索节点
- 访问设置和运行时状态
- 远程触发注入节点
- 输出和可视化流和统计数据
安装
全球安装
npm install -g node-red-mcp-server本地安装
npm install node-red-mcp-server用法
命令行
node-red-mcp-server --url http://localhost:1880 --token YOUR_TOKEN通过配置 .env
创建一个 .env 文件:
NODE_RED_URL=http://localhost:1880
NODE_RED_TOKEN=YOUR_TOKEN然后运行:
node-red-mcp-server与Claude或其他法学硕士整合
- 启动MCP服务器或使用下面的工具配置配置Claude Desktop以自动启动它。
- 配置Claude桌面:
- 打开克劳德桌面应用程序 - 转到“设置”→ 高级→ 工具配置 - 添加新的工具配置。您可以使用 npx 无需手动安装即可运行服务器。这通常是最简单的入门方法:
{
"node-red": {
"command": "npx",
"args": [
"node-red-mcp-server"
],
"env": {
"NODE_RED_URL": "http://your-node-red-url:1880",
"NODE_RED_TOKEN": "your-token-if-needed"
}
}
}- 确保 NODE_RED_URL 指向您的Node-RED实例。 - 集 NODE_RED_TOKEN 如果你的Node-RED实例需要身份验证。
或者,如果您已全局或本地安装了服务器,并且知道脚本的路径,则可以按如下方式配置它:
{
"node-red": {
"command": "node",
"args": [
"/path/to/node-red-mcp-server/bin/node-red-mcp-server.mjs"
// You can add other CLI arguments here, e.g., "--verbose"
],
"env": {
"NODE_RED_URL": "http://your-node-red-url:1880",
"NODE_RED_TOKEN": "your-token-if-needed",
"MCP_SERVER_PORT": "3000"
}
}
}- 替换 /path/to/node-red-mcp-server 安装的实际路径 - 更新 NODE_RED_URL 指向您的Node-RED实例 - 集 NODE_RED_TOKEN 如果你的Node-RED实例需要身份验证
- 配置后,Claude可以通过MCP工具与您的Node-RED实例进行交互。
有关模型上下文协议的更多信息,请访问 MCP官方文件.
程序化使用
import { createServer } from 'node-red-mcp-server';
const server = createServer({
nodeRedUrl: 'http://localhost:1880',
nodeRedToken: 'YOUR_TOKEN',
verbose: true
});
await server.start();配置选项
CLI参数
| 参数 | 简短 | 说明 |
|---|---|---|
--url | -u | 节点RED基本URL |
--token | -t | API访问令牌 |
--verbose | -v | 启用详细日志记录 |
--help | -h | 显示帮助 |
--version | -V | 显示版本号 |
环境变量
| 变量 | 描述 |
|---|---|
NODE_RED_URL | Node-RED实例的URL |
NODE_RED_TOKEN | API访问令牌 |
MCP工具
流量工具
get-flows--获取所有流量update-flows--更新所有流get-flow--按ID获取特定流update-flow--按ID更新特定流list-tabs--列出所有选项卡(工作区)create-flow--创建新的流选项卡delete-flow--删除流选项卡get-flows-state--获取部署状态set-flows-state--更改部署状态get-flows-formatted--获取人类可读的流程列表visualize-flows--生成流的图形化视图
节点工具
inject--触发注入节点get-nodes--列出可用节点类型get-node-info--关于节点模块的详细信息toggle-node-module--启用/禁用节点模块find-nodes-by-type--按类型定位节点search-nodes--按名称或属性查找节点
设置工具
get-settings--获取Node-RED运行时设置get-diagnostics--获取诊断信息
实用工具
api-help-显示Node-RED API帮助
需求
- Node.js v16或更新版本
- 正在运行的具有HTTP API访问权限的Node-RED实例
许可证
MIT许可证
版权所有(c)2023
特此免费授予任何获得本软件和相关文档文件(“软件”)副本的人在不受限制的情况下处理软件的权限,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,以及允许获得软件的人这样做,但须符合以下条件:
上述版权声明和本许可声明应包含在软件的所有副本或实质部分中。
软件按“原样”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下,作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任,无论是在合同、侵权或其他诉讼中。
