金大哥 - n8n MCP 详情

article

README

🚀 n8n MCP 服务器

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

🚀 快速开始

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

📦 安装指南

获取你的 n8n API Key

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

安装 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 工作流”。
如果一切正常，你应该会看到返回的工作流信息。

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

✨ 主要特性

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

🔧 技术细节

故障排除

常见问题

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

📄 许可证

本项目采用 MIT License。

支持

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

n8n