用途：安装部署 xiaohongshu-mcp 服务并配置 MCP 连接，覆盖从零到可用的全流程。适用于首次使用小红书功能、需要安装/部署/配置、环境搭建、MCP 连接失败，或 check_login_status 等工具不可用时。项目仓库：https://github.com/xpzouying/xiaohongshu-mcp
主要能力与流程：
- 检测服务状态。MCP 端点只接受 POST，GET 返回 405，不能用 -f 判断：curl -so /dev/null http://localhost:18060/mcp && echo "running" || echo "not running"。已运行则记录地址并进入配置检测；未运行则询问是否部署在其他地址/端口。
- 部署服务。确认操作系统与是否安装 Docker。方式一 Docker Compose（推荐，镜像内置 Chrome 和中文字体）：wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml，docker compose up -d，docker compose logs -f。镜像源默认 Docker Hub 的 xpzouying/xiaohongshu-mcp，国内可用阿里云 crpi-hocnvtkomt7w9v8t.cn-beijing.personal.cr.aliyuncs.com/xpzouying/xiaohongshu-mcp，切换需编辑 docker-compose.yml。数据持久化：./data 存 cookies 登录状态，./images 为发布图片挂载目录。方式二从 GitHub Releases 下载二进制，需本机已装 Chrome 或 Chromium。方式三源码编译，不推荐，仅适合 Go 开发者。
- 检测 MCP 连接配置。Claude Code 读取 ~/.claude/settings.json 和项目级 .claude/settings.json，查找 mcpServers 中的 xiaohongshu 配置。
- 配置 MCP 连接。Claude Code 可用 claude mcp add xiaohongshu --transport http <地址>，或写入配置文件（全局 ~/.claude/settings.json、项目级 .claude/settings.json）；Cursor 写入 .cursor/mcp.json，格式为 mcpServers 下 xiaohongshu 的 url 字段。其他客户端按各自文档配置。
- 验证与提示。配置变更后需重启客户端会话，重启后调用 check_login_status 验证，成功后引导使用 /xhs-login 扫码登录。
可选环境变量：XHS_PROXY（HTTP/HTTPS/SOCKS5 代理）、ROD_BROWSER_BIN（自定义 Chromium 路径）、HEADLESS（无头模式开关）。
失败处理：Docker 未安装建议安装或改用二进制；国内拉取慢切换阿里云镜像源；端口 18060 被占用检查进程或更换端口；二进制方式缺 Chrome 则安装或改用 Docker；配置后工具仍不可用需重启客户端；已有配置地址错误则修正并重启。
限制：具体收费、价格、平台支持范围等资料暂未提供。