n8n-mcp服务器
项目介绍
n8n MCP 服务器
一个通过模型上下文协议（Model Context Protocol）提供对 n8n 工作流、执行、凭据等访问的 MCP 服务器。这允许大型语言模型（LLMs）以安全和标准化的方式与 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 安装时，服务器将在您的 PATH 中作为 n8n-mcp-server 可用。
配置
Claude Desktop
-
打开您的 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 Code)
- 安装服务器（遵循上述安装步骤）
- 打开 VS Code
- 从左侧边栏打开 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 命令
Sage
即将推出！n8n MCP 服务器将通过以下方式可用：
- Smithery.ai 市场
- 从 Claude Desktop 导入
目前，请使用 Claude Desktop 或 Cline。
验证
配置后：
- 重新启动您的 LLM 应用程序
- 询问：“列出我的 n8n 工作流”
- 您应该能看到您的工作流列表
如果遇到错误：
- 检查您的 n8n 实例是否正在运行
- 验证您的 API 密钥具有正确的权限
- 确保 N8N_HOST 不带尾随斜杠
功能
核心功能
- 列出和管理工作流
- 查看工作流详情
- 执行工作流
- 管理凭据
- 处理标签和执行
- 生成安全审计
- 管理工作流标签
企业功能
这些功能需要 n8n 企业许可证：
- 项目管理
- 变量管理
- 高级用户管理
故障排除
常见问题
-
“客户端未初始化”
- 检查 N8N_HOST 和 N8N_API_KEY 是否正确设置
- 确保 n8n 实例可访问
- 验证 API 密钥权限
-
“需要许可证”
- 您正在尝试使用企业功能
- 要么升级到 n8n 企业版，要么仅使用核心功能
-
连接问题
- 验证 n8n 实例是否正在运行
- 检查 URL 协议（http/https）
- 移除 N8N_HOST 尾随斜杠
安全最佳实践
-
API 密钥管理
- 使用必要的最小权限
- 定期轮换密钥
- 不要将密钥提交到版本控制
-
实例访问
- 生产环境使用 HTTPS
- 启用 n8n 认证
- 保持 n8n 更新