AI导哈

n8n MCP服务器

一个通过模型上下文协议提供对n8n工作流、执行、凭证等访问的服务器，使大型语言模型能够以安全标准化的方式与n8n实例交互。

  • by mh8974
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mh8974/n8n-mcp-server

使用说明

n8n MCP 服务器

一个通过模型上下文协议提供对n8n工作流、执行、凭证等访问的MCP服务器。这使得大型语言模型（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 在你的路径中。

配置

Claude Desktop

  1. 打开你的Claude桌面配置：

    ~/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 Code）

  1. 安装服务器（按照上述安装步骤操作）
  2. 打开VS Code
  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命令

Sage

即将推出！n8n MCP 服务器将通过以下方式提供：

  • Smithery.ai市场
  • 从Claude桌面导入

目前，请使用Claude Desktop或Cline。

验证

配置后：

  1. 重启您的大型语言模型应用程序
  2. 询问：“列出我的n8n工作流”
  3. 你应该能看到你的工作流程列出来

如果你遇到错误：

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

功能

核心功能

  • 列出并管理工作流程
  • 查看工作流详情
  • 执行工作流
  • 管理凭据
  • 处理标签和执行
  • 生成安全审计报告
  • 管理工作流标签

企业功能

这些功能需要n8n企业版许可证：

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

故障排除

常见问题

  1. 客户端未初始化

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

  2. 需要许可证

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

  3. 连接问题

    • 验证n8n实例是否正在运行
    • 检查URL协议（http/https）
    • 从N8N_HOST中移除尾部斜杠

安全最佳实践

  1. API密钥管理

    • 使用必要的最小权限
    • 定期更换密码
    • 不要将密钥提交到版本控制系统中

  2. 实例访问

    • 在生产环境中使用HTTPS
    • 启用n8n身份验证
    • 保持n8n更新

支持

许可证

麻省理工学院许可证

相关 MCP