n8n MCP Server

n8n MCP 服务

一个通过模型上下文协议提供 n8n 工作流、执行记录、凭据等访问能力的 MCP 服务。这使大语言模型（LLM）能够以安全、标准化的方式与 n8n 实例交互。

安装

获取 n8n API 密钥

1. 登录你的 n8n 实例
2. 点击左下角的用户图标
3. 前往「Settings」
4. 选择「API」
5. 点击「Create API Key」
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 安装时，服务将在你的 PATH 中以 n8n-mcp-server 的名称提供。

配置

Claude Desktop

1. 打开 Claude Desktop 配置文件：

   ~/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 Servers」图标
5. 滚动到底部并点击「Configure MCP Servers」
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 Desktop 导入

目前，请使用 Claude Desktop 或 Cline。

验证

完成配置后：

1. 重启你的 LLM 应用程序
2. 提问：「列出我的 n8n 工作流」
3. 你应该会看到列出的工作流

如果出现错误：

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

功能

核心功能

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

企业版功能

这些功能需要 n8n Enterprise 许可证：

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

故障排除

常见问题

1. “客户端未初始化”

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

2. “需要许可证”

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

3. 连接问题

   • 确认 n8n 实例正在运行
   • 检查 URL 协议（http/https）
   • 移除 N8N_HOST 末尾的斜杠

安全最佳实践

1. API 密钥管理

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

2. 实例访问

   • 在生产环境中使用 HTTPS
   • 启用 n8n 身份验证
   • 保持 n8n 为最新版本

支持

• GitHub 问题
• n8n 文档

许可证

MIT 许可证