n8n MCP 服务器

你是否曾经希望AI能够直接与n8n工作流交互，列出工作流、执行自动化任务、管理凭证和标签？今天要介绍的开源项目n8n MCP服务器，正是为了实现这个目标而设计的。它通过MCP协议实现与n8n工作流、执行和设置的安全交互，专为与LLMs集成而设计。

项目基本信息

一、项目介绍

n8n MCP服务器是一个让AI能够与n8n工作流平台交互的MCP工具。它允许LLM以安全标准化的方式与n8n实例进行交互，管理工作流、执行、凭证等。

这个服务器提供了以下核心功能：

• 工作流管理：列出、查看详情、执行工作流
• 凭证管理：管理工作流凭证
• 标签管理：处理工作流标签
• 执行记录：查看工作流执行历史
• 安全审计：生成安全审计报告
• 企业功能：项目管理、变量管理（需企业许可证）

二、核心优势

AI与n8n集成

让AI能够通过自然语言操作n8n工作流。

核心功能完整

覆盖工作流管理的主要操作。

安全设计

API密钥管理，最小权限原则。

企业功能支持

支持项目管理、变量管理等企业特性。

易于安装

通过npm一键安装。

三、适用场景

AI驱动的工作流自动化

让AI根据需求自动执行n8n工作流。

工作流监控

AI可以定期检查工作流执行状态。

凭证管理

AI可以帮助管理工作流凭证。

审计报告

AI可以生成工作流安全审计报告。

四、安装教程

系统要求

安装步骤

第一步：获取n8n API密钥

1. 登录您的n8n实例
2. 点击左下角用户图标 -> 设置 -> API
3. 点击“创建API密钥”
4. 复制生成的API密钥

第二步：安装MCP服务器

通过npm安装（推荐）：

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

从源代码安装：

git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server
npm install
npm run build

第三步：配置Claude Desktop

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

添加配置：

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

注意：N8N_HOST不要有尾随斜杠。

第四步：配置Cline（VS Code）

1. 打开Cline扩展
2. 点击“MCP服务器”图标
3. 点击“配置MCP服务器”
4. 添加上述配置

第五步：验证安装

重启LLM应用程序，询问：“列出我的n8n工作流”，应该看到工作流列表。

五、使用示例

示例1：列出工作流

用户指令：“列出我的n8n工作流”

AI会调用相应工具，返回工作流列表。

示例2：执行工作流

用户指令：“执行ID为123的工作流”

AI会触发工作流执行，返回执行结果。

示例3：查看工作流详情

用户指令：“查看工作流‘数据处理’的详细信息”

AI会返回工作流配置、节点等信息。

示例4：管理工作流标签

用户指令：“给工作流‘日报’添加‘自动化’标签”

AI会更新工作流的标签。

示例5：生成审计报告

用户指令：“生成工作流安全审计报告”

AI会分析工作流配置和凭证使用情况。

六、企业功能

以下功能需要n8n企业许可证：

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

七、安全最佳实践

API密钥管理：

• 使用最小必要权限
• 定期轮换密钥
• 切勿将密钥提交到版本控制

实例访问：

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

八、常见问题

问题1：客户端未初始化

解决方案：检查N8N_HOST和N8N_API_KEY是否正确，确保n8n实例可访问。

问题2：需要许可证

解决方案：正在使用企业功能，要么升级到企业版，要么仅使用核心功能。

问题3：连接问题

解决方案：验证n8n实例是否运行，检查URL协议，从N8N_HOST中删除尾随斜杠。

问题4：API密钥无效

解决方案：重新生成API密钥，确认权限正确。

问题5：工作流执行失败

解决方案：检查工作流配置，确认输入参数正确。

九、总结

n8n MCP服务器是一个让AI能够与n8n工作流平台交互的MCP工具，支持工作流管理、执行、凭证管理等核心功能。

这个项目的最大价值在于：

1. AI驱动自动化：让AI操作n8n工作流
2. 核心功能完整：工作流、凭证、标签管理
3. 安全设计：API密钥管理最佳实践
4. 企业功能：项目、变量管理
5. 易于集成：支持Claude Desktop和Cline

如果你使用n8n工作流平台，并且希望用AI来自动化工作流管理，n8n MCP服务器是一个非常实用的工具。