目录一、前言二、准备工作2.1 系统环境说明2.2 必装依赖仅2个极简1Node.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登录工具运行后无弹窗/下载浏览器失败问题2Cursor提示「无法连接到MCP服务」问题3发布图文提示「图片路径错误」问题4账号被踢下线七、总结一、前言小红书MCPxiaohongshu-mcp是一款能实现小红书自动化运营的工具支持登录验证、图文/视频发布、评论互动、用户信息查询等核心功能。相比源码编译、Docker部署下载预编译安装包是最快捷的方式无需配置开发环境新手也能快速上手。本文将全程基于「安装包下载」的方式手把手教你完成小红书MCP的部署、接入Cursor编辑器并演示核心功能的使用让你轻松实现小红书内容的自动化管理。二、准备工作2.1 系统环境说明支持的系统版本请对应下载macOSApple Siliconarm64/ Intelamd64Windowsx64Windows 10/11 均可Linuxx642.2 必装依赖仅2个极简1Node.js用于MCP连接验证无论哪个系统建议通过官方推荐方式安装Node.js LTS版本确保环境变量自动配置Windows打开「管理员命令行」执行/* by 01130.hk - online tools website : 01130.hk/zh/generatetronwallets.html */ winget install OpenJS.NodeJS.LTSmacOS/Linux参考 Node.js官方下载页 安装LTS版本2网络环境首次运行会自动下载无头浏览器约150MB需确保网络通畅后续无需重复下载。2.3 下载小红书MCP安装包打开 xiaohongshu-mcp的GitHub Releases页面根据自己的系统下载对应安装包Windows x64xiaohongshu-mcp-windows-amd64.zipmacOS Apple Siliconxiaohongshu-mcp-darwin-arm64.zipmacOS Intelxiaohongshu-mcp-darwin-amd64.zipLinux x64xiaohongshu-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.exeMCP主服务程序其他系统对应文件macOS是xiaohongshu-login-darwin-arm64/xiaohongshu-mcp-darwin-arm64Linux是xiaohongshu-login-linux-amd64/xiaohongshu-mcp-linux-amd64。3.2 运行登录工具完成小红书认证这是核心步骤MCP服务依赖登录后的Cookies才能正常工作打开终端/命令行进入解压目录Windows在解压文件夹空白处右键 → 「在终端中打开」macOS/Linux打开终端执行cd /你的解压路径/xiaohongshu-mcp运行登录工具Windows/* by 01130.hk - online tools website : 01130.hk/zh/generatetronwallets.html */ ./xiaohongshu-login-windows-amd64.exemacOS/Linuxchmod x xiaohongshu-login-darwin-arm64 # 赋予执行权限仅首次 ./xiaohongshu-login-darwin-arm64登录流程运行后会自动下载无头浏览器耐心等待弹出小红书登录页面扫码/手机号登录均可登录成功后终端会提示「登录成功」并自动生成cookies.json文件保存在当前目录切勿删除。⚠️ 重要提醒小红书账号不允许多网页端登录登录MCP后不要在其他浏览器登录同一账号否则会被踢下线手机App登录不受影响。3.3 启动MCP主服务登录成功后继续在终端执行以下命令启动MCP服务Windows# 无头模式无浏览器界面推荐生产使用 ./xiaohongshu-mcp-windows-amd64.exe # 非无头模式有浏览器界面调试用 ./xiaohongshu-mcp-windows-amd64.exe -headlessfalsemacOS/Linuxchmod x xiaohongshu-mcp-darwin-arm64 # 赋予执行权限仅首次 # 无头模式 ./xiaohongshu-mcp-darwin-arm64 # 非无头模式 ./xiaohongshu-mcp-darwin-arm64 -headlessfalse启动成功的标志终端无报错且显示「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配置文件打开Cursor编辑器确认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的连接打开Cursor新建一个对话窗口在输入框中输入检查小红书MCP的登录状态发送指令后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登录工具运行后无弹窗/下载浏览器失败原因网络限制或权限不足解决方案确保网络能访问外网或切换网络重试Windows需以管理员身份运行终端macOS/Linux需赋予文件执行权限chmod x 文件名。问题2Cursor提示「无法连接到MCP服务」原因MCP服务未启动/端口被占用/配置文件路径错误解决方案检查MCP服务是否正常运行终端是否显示端口18060确认.cursor/mcp.json中的URL是http://localhost:18060/mcp检查18060端口是否被占用Windowsnetstat -ano | findstr 18060macOS/Linuxlsof -i:18060占用则关闭对应进程。问题3发布图文提示「图片路径错误」原因图片路径不是绝对路径/未放到指定目录解决方案使用绝对路径如D:\xiaohongshu-mcp\images\test.jpg确保图片文件存在且路径无中文/空格。问题4账号被踢下线原因同一账号在其他网页端登录解决方案退出其他网页端的小红书登录重新运行登录工具重新生成Cookies。七、总结通过「下载安装包」的方式部署小红书MCP全程无需配置复杂的开发环境如Golang、Docker新手也能在10分钟内完成部署。接入Cursor后可直接通过自然语言调用MCP的所有功能实现小红书登录验证、图文/视频发布、评论互动等自动化操作。⚠️ 风险提示该工具仅用于学习和个人合法运营请勿用于违规操作Cookies过期后需重新登录正常使用下不会导致账号封禁。如果在部署过程中遇到问题可参考项目的官方文档xiaohongshu-mcp README或在GitHub Issues中提问。