logo
0
0
WeChat Login
Zhongpeng<47939471+laryzhong@users.noreply.github.com>
Feature/n8n integration (#78)

N8N 接入 xiaohongshu-mcp 完整指南

📋 概述

本文档详细介绍了如何部署汉化版 n8n 工作流平台,并集成 xiaohongshu-mcp 服务,实现自动化小红书内容发布功能。

🚀 环境准备

前置要求

  • Docker 和 Docker Compose 已安装
  • xiaohongshu-mcp 服务已正常启动
  • 有效的 DeepSeek API 密钥

📦 n8n 部署指南

1. 下载汉化包

前往 n8n 汉化包项目 下载最新版本的汉化文件。

操作步骤:

  1. 下载最新的汉化包压缩文件
  2. 解压下载的文件
  3. 确保解压后包含 editor-ui/dist 文件夹

2. Docker Compose 部署(推荐)

创建 docker-compose.yml 文件,内容如下:

version: '3' services: n8n: image: n8nio/n8n container_name: n8n restart: unless-stopped ports: - "5678:5678" volumes: # 运行数据挂载 - 确保工作流数据持久化 - ./n8n_data:/home/node/.n8n # 汉化包挂载 - 替换为你的汉化包路径 - ./editor-ui/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist environment: - N8N_HOST=localhost - N8N_PORT=5678 - N8N_PROTOCOL=http # 可选:设置基本认证(增强安全性) # - N8N_BASIC_AUTH_ACTIVE=true # - N8N_BASIC_AUTH_USER=myuser # - N8N_BASIC_AUTH_PASSWORD=mypassword # 时区设置(亚洲/上海) - GENERIC_TIMEZONE=Asia/Shanghai # 调试时禁用安全Cookie(方便本地访问) - N8N_SECURE_COOKIE=false # 设置默认语言为简体中文 - N8N_DEFAULT_LOCALE=zh-CN networks: - n8n-network networks: n8n-network: driver: bridge

启动服务:

docker-compose up -d

3. Docker 直接部署(备选方案)

创建启动脚本或直接运行命令:

docker run -it --name n8nChinese \ -p 5678:5678 \ -v "/path/to/editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist" \ -v "${HOME}/.n8n:/home/node/.n8n" \ -e N8N_DEFAULT_LOCALE=zh-CN \ -e N8N_SECURE_COOKIE=false \ n8nio/n8n

4. 访问和初始化

  1. 打开浏览器访问:http://localhost:5678
  2. 首次访问需要输入邮箱地址进行注册
  3. n8n 会向该邮箱发送激活码
  4. 按提示输入激活码完成初始化

初始化界面 激活界面

⚠️ 重要注意事项

  • 数据持久化:务必挂载本地目录保存工作流数据,避免容器重启后数据丢失
  • 端口冲突:如端口 5678 被占用,可修改 -p 参数映射其他端口
  • 汉化配置N8N_DEFAULT_LOCALE=zh-CN 环境变量强制设置为简体中文界面
  • 安全警告:生产环境建议启用基本认证和安全Cookie设置

🔌 接入 xiaohongshu-mcp 服务

前提条件

确保 xiaohongshu-mcp 服务已正常启动并运行

配置步骤

步骤 1:创建工作流

在 n8n 控制台中创建新的工作流:

创建工作流

步骤 2:导入工作流配置

导入本目录中的配置文件:

  • 文件名称:自动发布笔记到小红书.json
  • 操作:点击"导入工作流"选择该文件

导入工作流

步骤 3:配置大模型节点

  1. 选择 AI 大模型节点(支持 DeepSeek、OpenAI 等)
  2. 配置大模型连接凭证
  3. 以 DeepSeek 为例,需要申请 API 密钥

DeepSeek API 密钥申请:

选择大模型 配置凭证 完成配置

步骤 4:配置 MCP 服务

  1. 双击 MCP 节点进行配置

配置MCP节点

  1. 修改连接设置

    • 将 IP 地址修改为你实际的 xiaohongshu-mcp 服务 IP
    • 默认导入所有可用的工具函数

    修改IP配置

  2. 测试连接

    • 点击"执行步骤"测试连接
    • 选择一个接口进行功能测试
    • 返回成功表示接入正常

    测试连接 测试成功

🎯 开始使用

执行工作流

  1. 点击"开始执行该步骤"
  2. 在聊天框中输入提示词
  3. 系统会自动处理并发布内容

开始执行

示例提示词

给我发布一篇关于重庆旅游的小红书爆款笔记,配图找"重庆打卡"点赞最高的一张

效果展示

测试过程 测试结果

🛠️ 故障排除

常见问题

  1. 连接失败:检查 xiaohongshu-mcp 服务是否正常运行
  2. API 密钥错误:确认 DeepSeek API 密钥有效且未过期
  3. 汉化不生效:检查汉化包路径是否正确挂载
  4. 端口冲突:修改 docker-compose.yml 中的端口映射

获取帮助

  • 查看 n8n 官方文档:https://docs.n8n.io
  • 参考 xiaohongshu-mcp 项目文档
  • 检查日志文件排查具体错误

📁 项目文件说明

  • docker-compose.yml - Docker Compose 部署配置文件
  • 自动发布笔记到小红书.json - n8n 工作流配置文件
  • images/ - 说明文档相关截图
  • editor-ui/dist/ - 汉化包文件(需自行下载)

🎉 完成部署

通过以上步骤,您已成功部署汉化版 n8n 并集成 xiaohongshu-mcp 服务,可以开始自动化小红书内容发布工作了!