
5分钟部署n8n-mcp与Hetzner云企业级工作流自动化方案【免费下载链接】n8n-mcp项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcpn8n-mcp是一款强大的Model Context Protocol服务器为AI助手提供全面的n8n节点文档访问和管理能力。通过Hetzner云平台部署n8n-mcp您可以快速构建企业级工作流自动化系统实现AI驱动的工作流创建、验证和管理。 为什么选择Hetzner云部署n8n-mcpHetzner云平台为n8n-mcp提供了理想的运行环境具有以下优势成本效益提供业界领先的性价比适合从小型项目到企业级部署性能可靠稳定的服务器性能确保工作流处理的高效运行全球节点分布在多个数据中心可选择离您最近的区域部署简单易用直观的管理界面和完善的API降低部署和维护难度 服务器准备与要求推荐配置最低配置1 vCPU1GB RAMHetzner CX11实例推荐配置2 vCPU2GB RAM确保流畅运行和未来扩展操作系统Ubuntu 22.04 LTS初始服务器设置通过SSH连接到您的Hetzner服务器ssh rootyour-server-ip更新系统并安装必要依赖apt update apt upgrade -y curl -fsSL https://get.docker.com | sh 快速Docker部署推荐1. 拉取最新镜像# 始终先拉取最新镜像以避免使用缓存版本 docker pull ghcr.io/czlonkowski/n8n-mcp:latest2. 生成安全令牌# 生成安全令牌保存此令牌 AUTH_TOKEN$(openssl rand -hex 32) echo Your AUTH_TOKEN: $AUTH_TOKEN3. 运行容器docker run -d \ --name n8n-mcp \ -p 3000:3000 \ -e N8N_MODEtrue \ -e MCP_MODEhttp \ -e N8N_API_URLhttps://your-n8n-instance.com \ -e N8N_API_KEYyour-n8n-api-key \ -e MCP_AUTH_TOKEN$AUTH_TOKEN \ -e AUTH_TOKEN$AUTH_TOKEN \ -e LOG_LEVELinfo \ --restart unless-stopped \ ghcr.io/czlonkowski/n8n-mcp:latest 配置HTTPS与域名生产环境必备使用Docker Compose与Caddy实现自动HTTPS创建docker-compose.yml文件version: 3.8 services: n8n-mcp: image: ghcr.io/czlonkowski/n8n-mcp:latest pull_policy: always # 始终拉取最新镜像 container_name: n8n-mcp restart: unless-stopped environment: - N8N_MODEtrue - MCP_MODEhttp - N8N_API_URL${N8N_API_URL} - N8N_API_KEY${N8N_API_KEY} - MCP_AUTH_TOKEN${MCP_AUTH_TOKEN} - AUTH_TOKEN${AUTH_TOKEN} - PORT3000 - LOG_LEVELinfo networks: - web caddy: image: caddy:2-alpine container_name: caddy restart: unless-stopped ports: - 80:80 - 443:443 volumes: - ./Caddyfile:/etc/caddy/Caddyfile - caddy_data:/data - caddy_config:/config networks: - web networks: web: driver: bridge volumes: caddy_data: caddy_config:创建Caddyfilemcp.yourdomain.com { reverse_proxy n8n-mcp:3000 }创建环境变量文件AUTH_TOKEN$(openssl rand -hex 32) cat .env EOF N8N_API_URLhttps://your-n8n-instance.com N8N_API_KEYyour-n8n-api-key-here MCP_AUTH_TOKEN$AUTH_TOKEN AUTH_TOKEN$AUTH_TOKEN EOF启动服务docker compose up -d⚙️ 环境变量配置详解n8n-mcp的行为可以通过环境变量进行定制以下是关键配置项变量是否必需描述示例值N8N_MODE是启用n8n集成模式trueMCP_MODE是启用HTTP模式httpN8N_API_URL否*n8n实例URLhttps://n8n.example.comN8N_API_KEY否*n8n API密钥n8n_api_xxx...MCP_AUTH_TOKEN是MCP请求认证令牌至少32字符secure-random-32-char-tokenAUTH_TOKEN是必须与MCP_AUTH_TOKEN完全相同secure-random-32-char-tokenPORT否HTTP服务器端口3000默认*仅工作流管理功能需要文档工具无需这些配置 连接n8n与n8n-mcp配置n8n MCP Client Tool节点在n8n工作流中添加MCP Client Tool节点配置连接信息服务器URL必须包含/mcp端点同一服务器http://localhost:3000/mcp不同服务器https://mcp.yourdomain.com/mcp认证令牌之前生成的AUTH_TOKEN值传输方式HTTP Streamable (SSE)图n8n-mcp环境变量配置界面显示了关键参数设置✅ 验证部署部署完成后验证服务是否正常运行# 检查健康状态 curl http://localhost:3000/health # 检查MCP协议端点 curl http://localhost:3000/mcp # 应返回{protocolVersion:2024-11-05}成功部署后您将在Hetzner服务器上看到类似以下的部署状态图成功部署后的n8n-mcp服务状态显示活动状态和服务器地址️ 可用工具与功能连接成功后您可以使用以下MCP工具文档工具无需API密钥list_nodes- 列出所有n8n节点并支持筛选search_nodes- 按关键词搜索节点get_node_info- 获取节点详细信息validate_workflow- 验证工作流配置管理工具需要n8n API密钥n8n_create_workflow- 创建新工作流n8n_update_workflow- 更新现有工作流n8n_get_workflow- 获取工作流详情n8n_list_workflows- 列出所有工作流 安全最佳实践认证安全始终使用强随机令牌32字符定期轮换MCP_AUTH_TOKEN和AUTH_TOKEN网络安全生产环境必须使用HTTPS如本文Caddy配置只开放必要端口3000或443考虑配置IP白名单限制访问来源Docker安全定期更新镜像docker pull ghcr.io/czlonkowski/n8n-mcp:latest生产环境使用特定版本标签而非:latest考虑使用--read-only标志运行容器 故障排除常见问题解决连接被拒绝检查n8n-mcp是否运行docker ps | grep n8n-mcp查看日志docker logs n8n-mcp --tail 20验证端口是否开放netstat -tlnp | grep :3000认证失败确保MCP_AUTH_TOKEN和AUTH_TOKEN值相同检查令牌长度至少32字符确认没有多余空格或换行符n8n API连接问题验证N8N_API_URL是否包含协议http://或https://测试API密钥有效性curl -H X-N8N-API-KEY: your-api-key https://your-n8n-instance.com/api/v1/workflows 相关文档官方部署文档docs/N8N_DEPLOYMENT.md环境变量参考docs/N8N_DEPLOYMENT.md安全最佳实践SECURITY.md通过以上步骤您已成功在Hetzner云平台部署了n8n-mcp现在可以开始构建强大的AI驱动工作流自动化系统了【免费下载链接】n8n-mcp项目地址: https://gitcode.com/GitHub_Trending/n8/n8n-mcp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考