一、前言

小红书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：打开「管理员命令行」执行

winget install OpenJS.NodeJS.LTS

• macOS/Linux：参考 Node.js官方下载页[1] 安装LTS版本

（2）网络环境

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

2.3 下载小红书MCP安装包

1. 打开 xiaohongshu-mcp的GitHub Releases页面[2]
2. 根据自己的系统下载对应安装包：

• 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

3. 下载完成后，将压缩包解压到任意目录（建议路径不含中文/空格，比如 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才能正常工作：

1. 打开终端/命令行，进入解压目录：

• Windows：在解压文件夹空白处右键 → 「在终端中打开」
• macOS/Linux：打开终端，执行 cd /你的解压路径/xiaohongshu-mcp

2. 运行登录工具：

• Windows：
  bash ./xiaohongshu-login-windows-amd64.exe
• macOS/Linux：
  bash chmod +x xiaohongshu-login-darwin-arm64 # 赋予执行权限（仅首次） ./xiaohongshu-login-darwin-arm64

3. 登录流程：

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

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

3.3 启动MCP主服务

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

• Windows：

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

• macOS/Linux：

chmod +x xiaohongshu-mcp-darwin-arm64  # 赋予执行权限（仅首次）
  # 无头模式
  ./xiaohongshu-mcp-darwin-arm64
  # 非无头模式
  ./xiaohongshu-mcp-darwin-arm64 -headless=false

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

3.4 验证MCP服务是否正常

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

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配置文件

1. 打开Cursor编辑器；
2. 确认Cursor的MCP配置目录：

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

4.2 配置MCP连接信息

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

{
    "mcpServers": {
        "xiaohongshu-mcp": {
            "url": "http://localhost:18060/mcp",
            "description": "小红书内容发布服务 - MCP Streamable HTTP"
        }
    }
}

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

4.3 验证Cursor与MCP的连接

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

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

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

在Cursor对话框中输入：

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

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

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

步骤1：准备发布素材

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

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

@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 其他常用功能调用

• 发布视频：

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

• 获取用户个人主页：

@xiaohongshu-mcp 获取用户ID为123456的小红书个人主页信息

• 发表评论：

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

六、常见问题与解决方案

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

• 原因：网络限制或权限不足；
• 解决方案：

1. 确保网络能访问外网，或切换网络重试；
2. Windows需以管理员身份运行终端，macOS/Linux需赋予文件执行权限（chmod +x 文件名）。

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

• 原因：MCP服务未启动/端口被占用/配置文件路径错误；
• 解决方案：

1. 检查MCP服务是否正常运行（终端是否显示端口18060）；
2. 确认 .cursor/mcp.json 中的URL是 http://localhost:18060/mcp；
3. 检查18060端口是否被占用（Windows：netstat -ano | findstr 18060，macOS/Linux：lsof -i:18060），占用则关闭对应进程。

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

• 原因：图片路径不是绝对路径/未放到指定目录；
• 解决方案：

1. 使用绝对路径（如 D:\xiaohongshu-mcp\images\test.jpg）；
2. 确保图片文件存在，且路径无中文/空格。

问题4：账号被踢下线

• 原因：同一账号在其他网页端登录；
• 解决方案：

1. 退出其他网页端的小红书登录；
2. 重新运行登录工具，重新生成Cookies。

七、总结

通过「下载安装包」的方式部署小红书MCP，全程无需配置复杂的开发环境（如Golang、Docker），新手也能在10分钟内完成部署。接入Cursor后，可直接通过自然语言调用MCP的所有功能，实现小红书登录验证、图文/视频发布、评论互动等自动化操作。

⚠️ 风险提示：该工具仅用于学习和个人合法运营，请勿用于违规操作；Cookies过期后需重新登录，正常使用下不会导致账号封禁。

如果在部署过程中遇到问题，可参考项目的官方文档（xiaohongshu-mcp README[3]），或在GitHub Issues中提问。

引用链接

1. Node.js官方下载页: https://nodejs.org/zh-cn/download/
2. xiaohongshu-mcp的GitHub Releases页面: https://github.com/xpzouying/xiaohongshu-mcp/releases
3. xiaohongshu-mcp README: https://github.com/xpzouying/xiaohongshu-mcp