xhs-mcp-docker

What problem does it solve?

It solves the problem of publishing to 小红书 without relying on a pre-logged local Chrome profile, by providing a containerized MCP service that supports fresh QR-code login and persistent cookies.

Core Features & Use Cases

• QR Code Login in a Dockerized Chromium Session: Obtain a QR code from the MCP server, scan it with your phone, and have the service confirm login status for subsequent publishing.
• Persistent Session via Cookie Volumes: Save authentication cookies to a mounted host directory so you can restart the container without re-scanning.
• Image-Aware Publishing Pipeline: Publish content while referencing images that are mounted into the container data directory, enabling end-to-end media submission.
• Remote Access via Tailscale Proxy (Optional): Expose the local-only service safely to remote clients inside your tailnet.

Real-world use case: You deploy to a new machine or CI-like environment where you cannot reuse a logged-in browser profile, and you still need reliable 小红书 publishing with media uploads after a one-time QR login.

Quick Start

Start the MCP Docker service on your host (via its provided start script), fetch and scan the QR code, then call the publish endpoint with your title, content, tags, and image paths under the mounted data directory.