N8n

🚀 n8n MCP 服务器

n8n MCP 服务器通过 Model Context Protocol（MCP），为大型语言模型（LLMs）提供对 n8n 工作流、执行、凭据等的访问。这使得 LLMs 能够以安全且标准化的方式与 n8n 实例进行交互。

🚀 快速开始

按照以下步骤安装和配置 n8n MCP 服务器，使其与你的大型语言模型（LLMs）协同工作。

📦 安装指南

获取你的 n8n API Key

1. 登录到你的 n8n 实例。
2. 点击左下角的用户图标。
3. 进入设置。
4. 选择 API。
5. 点击“创建 API Key”。
6. 复制你的 API Key（你将无法再次看到它）。

安装 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 安装时，n8n-mcp-server 将会添加到你的 PATH 中。

📚 详细文档

配置

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 服务器”图标。
5. 滚动到底部并点击“配置 MCP 服务器”。
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. 如果一切正常，你应该会看到返回的工作流信息。

如果出现任何问题，请参考故障排除部分或联系支持团队。

✨ 主要特性

• 支持通过 MCP 协议与 LLMs 交互。
• 提供对 n8n 工作流的访问。
• 灵活的环境变量配置。
• 支持多种部署方式（本地、云等）。

🔧 技术细节

故障排除

常见问题

1. 无法连接到 n8n 实例：
   • 检查 API Key 是否正确。
   • 确保 n8n 服务正在运行且网络可达。
2. 权限问题：
   • 确认使用的 API Key 具有足够权限。
   • 查看 n8n 日志以获取更多信息。

📄 许可证

本项目采用 MIT License。

支持

如果你有任何问题或需要帮助，请访问 官方文档 或联系支持团队。