n8n MCP服务器
一个MCP服务器,通过模型上下文协议提供对n8n工作流、执行、凭据等的访问。这允许大型语言模型(LLM)以安全和标准化的方式与n8n实例进行交互。
安装
获取n8n API密钥
- 登录您的n8n实例
- 单击左下角的用户图标
- 转到“设置”
- 选择API
- 单击“创建API密钥”
- 复制您的API密钥(您将无法再次看到它)
安装MCP服务器
选项1:从npm安装(推荐)```bash
npm install -g @illuminaresolutions/n8n-mcp-server
#### 选项2:从源代码安装
1. 克隆存储库:```bash
git clone https://github.com/illuminaresolutions/n8n-mcp-server.git
cd n8n-mcp-server
- 安装依赖项并构建:```bash
npm install
npm run build
1. 在后台启动服务器:```bash
nohup npm start > n8n-mcp.log 2>&1 &
要停止服务器,请执行以下操作:```bash
pkill -f "node build/index.js"
注意:从npm安装时,服务器将作为 `n8n-mcp-server` 在你的路径。
## 配置
### 克劳德桌面
1. 打开您的Claude Desktop配置:```
~/Library/Application Support/Claude/claude_desktop_config.json
- 添加n8n配置:```json
{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_HOST": "https://your-n8n-instance.com",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
### Cline(VS代码)
1. 安装服务器(按照上面的安装步骤)
1. 打开VS代码
1. 从左侧边栏打开Cline扩展
1. 单击窗格顶部的“MCP服务器”图标
1. 滚动到底部并单击“配置MCP服务器”
1. 添加到打开的设置文件中:```json
{
"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更新
支持
- GitHub问题
- n8n文档
许可证
MIT许可证
