n8n MCP服务器

这是一个通过模型上下文协议（Model Context Protocol）提供对n8n工作流、执行记录、凭证等访问的MCP服务器。它允许大型语言模型（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的形式出现在您的PATH中。

配置

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更新

支持

许可证

MIT许可证