AI导哈

n8n工作流MCP服务器

通过模型上下文协议（MCP）为大型语言模型（LLMs）提供安全、标准化的n8n工作流、执行、凭证等访问服务。

  • by illuminaresolutions
  • TypeScript
  • 本地部署
  • 119 星标
  • 更新于
在 GitHub 查看 illuminaresolutions/n8n-mcp-server

使用说明

n8n MCP服务器

一个MCP服务器，通过模型上下文协议提供对n8n工作流、执行、凭据等的访问。这允许大型语言模型（LLM）以安全和标准化的方式与n8n实例进行交互。

安装

获取n8n API密钥

  1. 登录您的n8n实例
  2. 单击左下角的用户图标
  3. 转到“设置”
  4. 选择API
  5. 单击“创建API密钥”
  6. 复制您的API密钥（您将无法再次看到它）

安装MCP服务器

选项1：从npm安装（推荐）

npm install -g @illuminaresolutions/n8n-mcp-server

选项2：从源代码安装

  1. 克隆存储库：

    git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server

  2. 安装依赖项并构建：

    npm install
npm run build

  3. 在后台启动服务器：

    nohup npm start > n8n-mcp.log 2>&1 &

    要停止服务器，请执行以下操作：

    pkill -f "node build/index.js"

注意：从npm安装时，服务器将作为 n8n-mcp-server 在你的路径。

配置

克劳德桌面

  1. 打开您的Claude Desktop配置：

    ~/Library/Application Support/Claude/claude_desktop_config.json

  2. 添加n8n配置：

    {
  "mcpServers": {
     "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline（VS代码）

  1. 安装服务器（按照上面的安装步骤）
  2. 打开VS代码
  3. 从左侧边栏打开Cline扩展
  4. 单击窗格顶部的“MCP服务器”图标
  5. 滚动到底部并单击“配置MCP服务器”
  6. 添加到打开的设置文件中：
    {
  "mcpServers": {
    "n8n": {
      "command": "n8n-mcp-server",
      "env": {
        "N8N_HOST": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}
  7. 保存文件
  8. 确保MCP切换已启用（绿色），状态指示灯为绿色
  9. 开始在Cline中使用MCP命令

圣人

马上就来！n8n MCP服务器将通过以下方式提供：

  • Smithery.ai市场
  • 从Claude Desktop导入

目前，请使用Claude Desktop或Cline。

验证

配置后：

  1. 重新启动LLM应用程序
  2. 询问：“列出我的n8n工作流”
  3. 您应该看到您的工作流已列出

如果出现错误：

  • 检查n8n实例是否正在运行
  • 验证您的API密钥是否具有正确的权限
  • 确保N8N_HOST没有尾随斜线

特性

核心功能

  • 列出并管理工作流
  • 查看工作流详细信息
  • 执行工作流
  • 管理凭据
  • 处理标签和执行
  • 生成安全审核
  • 管理工作流标签

企业功能

这些功能需要n8n Enterprise许可证：

  • 项目管理
  • 变量管理
  • 高级用户管理

故障排除

常见问题

  1. “客户端未初始化”

    • 检查是否正确设置了N8N_HOST和N8N_API_KEY
    • 确保n8n实例可访问
    • 验证API密钥权限

  2. “需要许可证”

    • 您正在尝试使用企业功能
    • 升级到n8n Enterprise或仅使用核心功能

  3. 连接问题

    • 验证n8n实例是否正在运行
    • 检查URL协议（http/https）
    • 删除N8N_HOST的尾部斜线

安全最佳实践

  1. API密钥管理

    • 使用必要的最小权限
    • 定期旋转按键
    • 从不将密钥提交给版本控制

  2. 实例访问

    • 使用HTTPS进行生产
    • 启用n8n身份验证
    • 保持n8n更新

支持

许可证

MIT许可证

相关 MCP