零代码零基础！小红书MCP全自动化运营【保姆级安装教程】

@
目录

• 一、前言
  
• 二、准备工作
  
  
  
  • 2.1 系统环境说明
    
  • 2.2 必装依赖（仅2个，极简）
    
    
    
    • （1）Node.js（用于MCP连接验证）
      
    • （2）网络环境
      
    
    
  • 2.3 下载小红书MCP安装包
    
  
  
• 三、部署小红书MCP服务
  
  
  
  • 3.1 解压安装包并确认文件结构
    
  • 3.2 运行登录工具完成小红书认证
    
  • 3.3 启动MCP主服务
    
  • 3.4 验证MCP服务是否正常
    
  
  
• 四、接入Cursor编辑器
  
  
  
  • 4.1 找到Cursor的MCP配置文件
    
  • 4.2 配置MCP连接信息
    
  • 4.3 验证Cursor与MCP的连接
    
  
  
• 五、Cursor中使用小红书MCP实战
  
  
  
  • 5.1 基础功能：检查登录状态
    
  • 5.2 核心功能：发布小红书图文
    
    
    
    • 步骤1：准备发布素材
      
    • 步骤2：在Cursor中发送发布指令
      
    • 步骤3：查看发布结果
      
    
    
  • 5.3 其他常用功能调用
    
  
  
• 六、常见问题与解决方案
  
  
  
  • 问题1：登录工具运行后无弹窗/下载浏览器失败
    
  • 问题2：Cursor提示「无法连接到MCP服务」
    
  • 问题3：发布图文提示「图片路径错误」
    
  • 问题4：账号被踢下线
    
  
  
• 七、总结
  

一、前言

小红书MCP（xiaohongshu-mcp）是一款能实现小红书自动化运营的工具，支持登录验证、图文/视频发布、评论互动、用户信息查询等核心功能。相比源码编译、Docker部署，下载预编译安装包是最快捷的方式，无需配置开发环境，新手也能快速上手。

本文将全程基于「安装包下载」的方式，手把手教你完成小红书MCP的部署、接入Cursor编辑器，并演示核心功能的使用，让你轻松实现小红书内容的自动化管理。
二、准备工作

2.1 系统环境说明

支持的系统版本（请对应下载）：

• macOS：Apple Silicon（arm64）/ Intel（amd64）
  
• Windows：x64（Windows 10/11 均可）
  
• Linux：x64
  

2.2 必装依赖（仅2个，极简）

（1）Node.js（用于MCP连接验证）

无论哪个系统，建议通过官方推荐方式安装Node.js LTS版本，确保环境变量自动配置：

• Windows：打开「管理员命令行」执行
  1. winget install OpenJS.NodeJS.LTS

  复制代码
  
  
• macOS/Linux：参考 Node.js官方下载页 安装LTS版本
  

（2）网络环境

首次运行会自动下载无头浏览器（约150MB），需确保网络通畅，后续无需重复下载。
2.3 下载小红书MCP安装包

• 打开 xiaohongshu-mcp的GitHub Releases页面
  
• 根据自己的系统下载对应安装包：
  
  
  
  • Windows x64：xiaohongshu-mcp-windows-amd64.zip
    
  • macOS Apple Silicon：xiaohongshu-mcp-darwin-arm64.zip
    
  • macOS Intel：xiaohongshu-mcp-darwin-amd64.zip
    
  • Linux x64：xiaohongshu-mcp-linux-amd64.zip
    
    
  
• 下载完成后，将压缩包解压到任意目录（建议路径不含中文/空格，比如 D:\xiaohongshu-mcp 或 /Users/你的用户名/xiaohongshu-mcp）。
  

注意cookies.json是登录之后才会有的，刚刚解压完只会有我圈起来的这两个
三、部署小红书MCP服务

3.1 解压安装包并确认文件结构

解压后目录内会包含两个核心文件（以Windows为例）：

• xiaohongshu-login-windows-amd64.exe：登录工具（必先运行）
  
• xiaohongshu-mcp-windows-amd64.exe：MCP主服务程序
  

其他系统对应文件：macOS是xiaohongshu-login-darwin-arm64/xiaohongshu-mcp-darwin-arm64，Linux是xiaohongshu-login-linux-amd64/xiaohongshu-mcp-linux-amd64。

3.2 运行登录工具完成小红书认证

这是核心步骤，MCP服务依赖登录后的Cookies才能正常工作：

• 打开终端/命令行，进入解压目录：
  
  
  
  • Windows：在解压文件夹空白处右键 → 「在终端中打开」
    
  • macOS/Linux：打开终端，执行 cd /你的解压路径/xiaohongshu-mcp
    
    
  
• 运行登录工具：
  
  
  
  • Windows：
    1. ./xiaohongshu-login-windows-amd64.exe

    复制代码
    
    
  • macOS/Linux：
    1. chmod +x xiaohongshu-login-darwin-arm64  # 赋予执行权限（仅首次）
    2. ./xiaohongshu-login-darwin-arm64

    复制代码
    
    
    
  
• 登录流程：
  
  
  
  • 运行后会自动下载无头浏览器（耐心等待）；
    
  • 弹出小红书登录页面（扫码/手机号登录均可）；
    
  • 登录成功后，终端会提示「登录成功」，并自动生成 cookies.json 文件（保存在当前目录，切勿删除）。
    
    
  

⚠️ 重要提醒：小红书账号不允许多网页端登录，登录MCP后，不要在其他浏览器登录同一账号，否则会被踢下线（手机App登录不受影响）。

3.3 启动MCP主服务

登录成功后，继续在终端执行以下命令启动MCP服务：

• Windows：
  1. # 无头模式（无浏览器界面，推荐生产使用）
  2. ./xiaohongshu-mcp-windows-amd64.exe
  4. # 非无头模式（有浏览器界面，调试用）
  5. ./xiaohongshu-mcp-windows-amd64.exe -headless=false

  复制代码
  
  
• macOS/Linux：
  1. chmod +x xiaohongshu-mcp-darwin-arm64  # 赋予执行权限（仅首次）
  2. # 无头模式
  3. ./xiaohongshu-mcp-darwin-arm64
  4. # 非无头模式
  5. ./xiaohongshu-mcp-darwin-arm64 -headless=false

  复制代码
  
  

启动成功的标志：终端无报错，且显示「MCP服务启动成功，端口：18060」（默认端口18060，请勿占用）。

3.4 验证MCP服务是否正常

执行以下命令验证服务可用性：

1. npx @modelcontextprotocol/inspector

复制代码

左上角Transport Type下拉框，把STDIO改成Streamable HTTP；
改完后界面会出现URL输入框，把http://localhost:18060/mcp填到这个 URL 框里；
点击左侧的Connect按钮。
成功标志：左下角显示Connected

点击中间的List Tools
中间区域加载出小红书 MCP 的所有工具 / 能力列表、

四、接入Cursor编辑器

Cursor是支持MCP协议的AI编辑器，接入后可直接在Cursor中通过自然语言调用小红书MCP的所有功能，无需手动写接口请求。
4.1 找到Cursor的MCP配置文件

• 打开Cursor编辑器；
  
• 确认Cursor的MCP配置目录：
  
  
  
  • 核心配置文件路径参考：.cursor/mcp.json（可在Cursor的「设置→MCP」中找到配置入口，或直接在项目根目录创建该文件）。
    
    
  

4.2 配置MCP连接信息

创建/编辑 .cursor/mcp.json 文件，写入以下内容：

1. {
2.     "mcpServers": {
3.         "xiaohongshu-mcp": {
4.             "url": "http://localhost:18060/mcp",
5.             "description": "小红书内容发布服务 - MCP Streamable HTTP"
6.         }
7.     }
8. }

复制代码

保存文件后，重启Cursor让配置生效。

4.3 验证Cursor与MCP的连接

• 打开Cursor，新建一个对话窗口；
  
• 在输入框中输入：检查小红书MCP的登录状态；
  
• 发送指令后，Cursor会自动调用小红书MCP的「检查登录状态」功能，返回「当前账号已登录」即代表接入成功。
  

五、Cursor中使用小红书MCP实战

5.1 基础功能：检查登录状态

在Cursor对话框中输入：

1. 检查我的小红书账号登录状态

复制代码

发送后，MCP会返回当前账号的登录状态（已登录/未登录），如果未登录，需重新运行登录工具。

5.2 核心功能：发布小红书图文

步骤1：准备发布素材

• 本地图片：将图片放到MCP解压目录的 images 文件夹（没有则新建）；
  
• 文案：标题（≤20字）+ 正文（≤1000字）+ 标签（可选）。
  

步骤2：在Cursor中发送发布指令

1. @xiaohongshu-mcp 发布一篇小红书图文，标题：「新手必看的MCP部署教程」，正文：「无需编译源码，下载安装包就能部署小红书MCP，附Cursor接入全流程～」，图片使用本地路径：/Users/你的用户名/xiaohongshu-mcp/images/教程封面.jpg，添加标签：#MCP #小红书自动化 #Cursor

复制代码

注意：

• 图片路径需写绝对路径（Windows示例：D:\xiaohongshu-mcp\images\教程封面.jpg）；
  
• 标题和正文需符合小红书字数限制（标题≤20字，正文≤1000字）。
  

步骤3：查看发布结果

发送指令后，Cursor会返回发布进度，成功后可在小红书App中查看发布的笔记。
5.3 其他常用功能调用

• 发布视频：
  1. @xiaohongshu-mcp 发布小红书视频，标题：「MCP部署实操演示」，正文：「手把手教你部署小红书MCP～」，视频路径：/Users/你的用户名/xiaohongshu-mcp/videos/演示.mp4

  复制代码
  
  
• 获取用户个人主页：
  1. @xiaohongshu-mcp 获取用户ID为123456的小红书个人主页信息

  复制代码
  
  
• 发表评论：
  1. @xiaohongshu-mcp 给帖子ID为741852的小红书笔记发表评论：「教程超实用！」

  复制代码
  
  

六、常见问题与解决方案

问题1：登录工具运行后无弹窗/下载浏览器失败

• 原因：网络限制或权限不足；
  
• 解决方案：
  
  
  • 确保网络能访问外网，或切换网络重试；
    
  • Windows需以管理员身份运行终端，macOS/Linux需赋予文件执行权限（chmod +x 文件名）。
    
    
  

问题2：Cursor提示「无法连接到MCP服务」

• 原因：MCP服务未启动/端口被占用/配置文件路径错误；
  
• 解决方案：
  
  
  • 检查MCP服务是否正常运行（终端是否显示端口18060）；
    
  • 确认 .cursor/mcp.json 中的URL是 http://localhost:18060/mcp；
    
  • 检查18060端口是否被占用（Windows：netstat -ano | findstr 18060，macOS/Linux：lsof -i:18060），占用则关闭对应进程。
    
    
  

问题3：发布图文提示「图片路径错误」

• 原因：图片路径不是绝对路径/未放到指定目录；
  
• 解决方案：
  
  
  • 使用绝对路径（如 D:\xiaohongshu-mcp\images\test.jpg）；
    
  • 确保图片文件存在，且路径无中文/空格。
    
    
  

问题4：账号被踢下线

• 原因：同一账号在其他网页端登录；
  
• 解决方案：
  
  
  • 退出其他网页端的小红书登录；
    
  • 重新运行登录工具，重新生成Cookies。
    
    
  

七、总结

通过「下载安装包」的方式部署小红书MCP，全程无需配置复杂的开发环境（如Golang、Docker），新手也能在10分钟内完成部署。接入Cursor后，可直接通过自然语言调用MCP的所有功能，实现小红书登录验证、图文/视频发布、评论互动等自动化操作。
⚠️ 风险提示：该工具仅用于学习和个人合法运营，请勿用于违规操作；Cookies过期后需重新登录，正常使用下不会导致账号封禁。
如果在部署过程中遇到问题，可参考项目的官方文档（xiaohongshu-mcp README），或在GitHub Issues中提问。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！