n8n MCP服务器
一个MCP服务器，通过模型上下文协议提供对n8n工作流、执行、凭据等的访问。这允许大型语言模型（LLM）以安全和标准化的方式与n8n实例进行交互。
安装
获取n8n API密钥
- 登录您的n8n实例
- 单击左下角的用户图标
- 转到“设置”
- 选择API
- 单击“创建API密钥”
- 复制您的API密钥（您将无法再次看到它）
安装MCP服务器
选项1：从npm安装（推荐）
npm install -g @illuminaresolutions/n8n-mcp-server选项2：从源代码安装
- 克隆存储库：
git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server- 安装依赖项并构建：
npm install
npm run build- 在后台启动服务器：
nohup npm start > n8n-mcp.log 2>&1 &要停止服务器，请执行以下操作：
pkill -f "node build/index.js"注意：从npm安装时，服务器将作为 n8n-mcp-server 在你的路径。
配置
克劳德桌面
- 打开您的Claude Desktop配置：
~/Library/Application Support/Claude/claude_desktop_config.json- 添加n8n配置：
{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_HOST": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}Cline（VS代码）
- 安装服务器（按照上面的安装步骤）
- 打开VS代码
- 从左侧边栏打开Cline扩展
- 单击窗格顶部的“MCP服务器”图标
- 滚动到底部并单击“配置MCP服务器”
- 添加到打开的设置文件中：
{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_HOST": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}- 保存文件
- 确保MCP切换已启用（绿色），状态指示灯为绿色
- 开始在Cline中使用MCP命令
圣人
马上就来！n8n MCP服务器将通过以下方式提供：
- Smithery.ai市场
- 从Claude Desktop导入
目前，请使用Claude Desktop或Cline。
验证
配置后：
- 重新启动LLM应用程序
- 询问：“列出我的n8n工作流”
- 您应该看到您的工作流已列出
如果出现错误：
- 检查n8n实例是否正在运行
- 验证您的API密钥是否具有正确的权限
- 确保N8N_HOST没有尾随斜线
特性
核心功能
- 列出并管理工作流
- 查看工作流详细信息
- 执行工作流
- 管理凭据
- 处理标签和执行
- 生成安全审核
- 管理工作流标签
企业功能
这些功能需要n8n Enterprise许可证：
- 项目管理
- 变量管理
- 高级用户管理
故障排除
常见问题
- “客户端未初始化”
- 检查是否正确设置了N8N_HOST和N8N_API_KEY - 确保n8n实例可访问 - 验证API密钥权限
- “需要许可证”
- 您正在尝试使用企业功能 - 升级到n8n Enterprise或仅使用核心功能
- 连接问题
- 验证n8n实例是否正在运行 - 检查URL协议（http/https） - 删除N8N_HOST的尾部斜线
安全最佳实践
- API密钥管理
- 使用必要的最小权限 - 定期旋转按键 - 从不将密钥提交给版本控制
- 实例访问
- 使用HTTPS进行生产 - 启用n8n身份验证 - 保持n8n更新