---

小红书 MCP 云端部署完整指南

📋 目录

1. 准备工作
2. 云服务器配置
3. Docker 安装与镜像拉取
4. 运行 MCP 服务
5. 开放网络端口
6. 首次登录（扫码）
7. 服务地址与使用
8. 常用管理命令
9. 常见问题排查

---

1️⃣ 准备工作

项目	要求
云服务器	阿里云/腾讯云/华为云等，Ubuntu 22.04 系统
服务器配置	建议 2核2G 以上
网络	需要开放 18060 端口
小红书账号	需要实名认证的账号

---

2️⃣ 云服务器配置

2.1 连接到服务器

ssh root@你的服务器公网IP

2.2 创建服务目录

# 创建工作目录（存放数据和图片）
mkdir -p ~/xiaohongshu-mcp/{data,images}
cd ~/xiaohongshu-mcp

---

3️⃣ Docker 安装与镜像拉取

3.1 安装 Docker

# Ubuntu 22.04
sudo apt update
sudo apt install -y docker.io

# 启动 Docker 并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

3.2 拉取镜像（使用阿里云镜像源，国内服务器推荐）

docker pull crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp

说明：如果使用海外服务器，可以直接拉取官方镜像：

docker pull xpzouying/xiaohongshu-mcp:latest

---

4️⃣ 运行 MCP 服务

4.1 启动容器

docker run -d \
  --name xiaohongshu \
  --restart=unless-stopped \
  -p 18060:18060 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/images:/app/images \
  crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp

参数说明：

参数	说明
-d	后台运行
--name xiaohongshu	容器名称
--restart=unless-stopped	自动重启
-p 18060:18060	端口映射
-v $(pwd)/data:/app/data	挂载数据目录（存储 cookies）
-v $(pwd)/images:/app/images	挂载图片目录

4.2 验证服务运行

# 查看容器状态
docker ps

# 查看服务日志
docker logs xiaohongshu

成功日志示例：

time="2026-05-13T09:08:33Z" level=info msg="Registered 13 MCP tools"
time="2026-05-13T09:08:33Z" level=info msg="MCP Server initialized with official SDK"
time="2026-05-13T09:08:33Z" level=info msg="启动 HTTP 服务器: :18060"

---

5️⃣ 开放网络端口

在云服务商控制台配置安全组

配置项	值
端口	18060
协议	TCP
来源	0.0.0.0/0（允许所有IP）
策略	允许

阿里云：云服务器 → 安全组 → 入方向 → 添加规则
腾讯云：云服务器 → 防火墙 → 添加规则

---

6️⃣ 首次登录（扫码）

由于云服务器没有图形界面，需要通过 MCP Inspector 完成首次登录。

6.1 在本地电脑执行

npx @modelcontextprotocol/inspector http://你的服务器公网IP:18060/mcp

6.2 扫码登录步骤

1. 打开浏览器中显示的 Inspector 页面
2. 找到 get_login_qrcode 工具，点击调用
3. 用小红书 App 扫描二维码
4. 调用 check_login_status 确认登录成功

成功标志： 看到 isLoggedIn: true

---

7️⃣ 服务地址与使用

7.1 MCP 服务地址

http://你的服务器公网IP:18060/mcp

7.2 配置到小智或其他 MCP 客户端

配置项	值
服务名称	小红书助手
端点	http://你的服务器公网IP:18060/mcp
协议	StreamableHttp
认证	无

7.3 图片发布说明

如果要发布本地图片：

1. 先将图片上传到服务器：

# 将图片上传到 images 目录
scp 本地图片.jpg root@服务器IP:~/xiaohongshu-mcp/images/

2. 在发布指令中指定路径：

/app/images/本地图片.jpg

---

8️⃣ 常用管理命令

# 查看服务状态
docker ps

# 查看实时日志
docker logs -f xiaohongshu

# 重启服务
docker restart xiaohongshu

# 停止服务
docker stop xiaohongshu

# 启动服务
docker start xiaohongshu

# 进入容器内部
docker exec -it xiaohongshu bash

# 更新镜像并重启
docker pull crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp
docker rm xiaohongshu
# 重新运行启动命令

# 删除容器（重新部署时）
docker rm xiaohongshu

---

9️⃣ 常见问题排查

Q1: 镜像拉取超时

错误： i/o timeout

解决： 使用阿里云镜像源

docker pull crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp

Q2: 端口无法访问

原因： 安全组未开放端口

解决： 在云服务商控制台开放 18060 端口

Q3: 登录后显示未登录

解决： Cookies 可能过期，重新扫码登录即可

Q4: 发布图片失败

解决：

• 确保图片在 /app/images/ 目录下
• 图片路径使用 /app/images/文件名.jpg

Q5: 容器自动停止

解决： 查看日志定位问题

docker logs xiaohongshu

---

📞 技术支持

• 项目地址：https://github.com/xpzouying/xiaohongshu-mcp
• 问题反馈：GitHub Issues

---

✅ 部署检查清单

• Docker 已安装并运行
• 镜像已成功拉取
• 容器正常运行（docker ps 显示 Up）
• 日志显示服务启动成功
• 云服务器安全组已开放 18060 端口
• 首次扫码登录成功
• check_login_status 返回 isLoggedIn: true

---

部署完成后，你的小红书 MCP 服务地址就是：

http://你的服务器公网IP:18060/mcp

团队成员直接在小智或其他 MCP 客户端配置这个地址即可使用！