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

TTGF2026-02-17 13:54

@
目录

一、前言

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

    bash 复制代码 
    winget install OpenJS.NodeJS.LTS

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

（2）网络环境

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

2.3 下载小红书MCP安装包

  1. 打开 xiaohongshu-mcp的GitHub Releases页面
  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：

    bash 复制代码 
    # 无头模式（无浏览器界面，推荐生产使用）
./xiaohongshu-mcp-windows-amd64.exe

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

  • macOS/Linux：

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

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

3.4 验证MCP服务是否正常

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

bash 复制代码 
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 文件，写入以下内容：

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），或在GitHub Issues中提问。

热门推荐
01使用 1panel面板 部署 php网站02从零搭建一个 PHP 登录注册系统（含完整源码）03GitHub 镜像站点04PHP Error: 常见错误及其解决方法05如何将 TRAE IDE 的插件市场源切换至 VS Code 官方市场06openClaw安装飞书插件｜核心踩坑：spawn EINVAL 错误终极解决指南07全面体验 Grok API 中转站（2025 · Grok 4 系列最新版）08BUUCTF[ACTF2020 新生赛]Include 1题解09MIUI显示/隐藏5G开关的方法，信号弱时开启手机Wifi通话方法10Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services