setup-xhs-mcp
This skill walks you through installing and configuring the xiaohongshu-mcp service, from initial deployment to verifying MCP connectivity. It supports Docker Compose (recommended), binary downloads, and source compilation, with built-in guidance for macOS, Linux, and Windows. After setup, it helps you register the MCP endpoint with Claude Code, Cursor, or other compatible clients.
setup-xhs-mcp guides you through deploying and configuring the xiaohongshu-mcp service end-to-end.
AI-generated summary based on this skill's SKILL.md
Install
autoclaw-cc/xiaohongshu-mcp-skills/setup-xhs-mcp
git clone https://github.com/autoclaw-cc/xiaohongshu-mcp-skills
cp -r xiaohongshu-mcp-skills/skills/setup-xhs-mcp ~/.claude/skills/setup-xhs-mcpnpx skillfed install autoclaw-cc/xiaohongshu-mcp-skills/setup-xhs-mcpFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I install xiaohongshu mcp?
setup-xhs-mcp offers three installation paths. For Docker Compose (recommended), clone the repository and run `docker compose up`. For binary installation, download the prebuilt executable for your OS from the releases page. For source compilation, clone the repo and run `cargo build --release`. All methods set up the MCP server on localhost:18060 by default. Choose Docker Compose for easiest setup across macOS, Linux, and Windows.
What should I do if xiaohongshu mcp connection fails?
setup-xhs-mcp provides troubleshooting steps for MCP connection issues. First, verify the server is running on localhost:18060 with `curl http://localhost:18060/health`. Check that your firewall allows port 18060. If using Docker, ensure the container is active via `docker ps`. Confirm your client (Claude Code, Cursor) has the correct endpoint URL configured. Review server logs for authentication or network errors, then restart the service and retry.
How do I configure mcp connection xiaohongshu with Claude Code?
setup-xhs-mcp guides you through Claude Code integration. In Claude Code settings, add a new MCP server with endpoint `http://localhost:18060`. Provide your xiaohongshu credentials when prompted. Test the connection by invoking a tool like `check_login_status`. If tools remain unavailable, verify the server is running and credentials are correct. Cursor setup follows the same pattern—add the endpoint and authenticate through the MCP configuration panel.
Why are xiaohongshu mcp tools not available after setup?
setup-xhs-mcp helps resolve tool availability issues by checking several factors. Confirm the MCP server process is running and listening on port 18060. Verify your xiaohongshu account credentials are valid and stored correctly in the service configuration. Restart both the MCP server and your client application. Check server logs for authentication failures or permission errors. If `check_login_status` fails, re-authenticate your xiaohongshu account through the setup wizard.
What are the setup xhs-mcp service deployment options?
setup-xhs-mcp supports three deployment methods tailored to your environment. Docker Compose is recommended for reproducible, isolated setups on any OS. Binary installation works for quick standalone deployments without container overhead. Source compilation gives you full control and is ideal for development. All three methods configure the same MCP server on localhost:18060. Docker Compose handles dependencies automatically; binary and source methods require manual environment setup for macOS, Linux, or Windows.
How do I resolve Docker image pull or port conflicts?
setup-xhs-mcp addresses Docker deployment issues. If image pull fails, check your internet connection and Docker daemon status. For port 18060 conflicts, either stop the process using that port or modify the Docker Compose `ports` mapping to a free port, then update your client configuration. Ensure Docker has sufficient disk space and memory. Run `docker compose logs` to see detailed error messages. If problems persist, rebuild the image locally with `docker compose build --no-cache`.
SKILL.md
rendered from the published skill — quoted content, verbatim
项目仓库：https://github.com/xpzouying/xiaohongshu-mcp
执行流程
1. 检测服务状态
检查 xiaohongshu-mcp 是否已在运行（注意：MCP 端点只接受 POST，GET 会返回 405，不能用 -f 判断）：
curl -so /dev/null http://localhost:18060/mcp && echo "running" || echo "not running"
- 已运行 → 记录地址
http://localhost:18060/mcp，跳到步骤 3 - 未运行 → 询问用户：服务是否部署在其他地址/端口？
- 用户提供地址 → 验证可达后跳到步骤 3
- 未部署 → 进入步骤 2
2. 部署服务
确认操作系统（macOS / Linux / Windows）和是否已安装 Docker。
方式一：Docker Compose（推荐）
Docker 镜像内置 Chrome 和中文字体，无需额外配置。
# 下载 docker-compose.yml
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，注释默认 image 行，取消注释阿里云 image 行。
数据持久化：
- ./data — cookies 登录状态
- ./images — 发布图片时的挂载目录
方式二：下载二进制
从 GitHub Releases
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/setup-xhs-mcp/SKILL.md