Captured at (local ISO): 2026-05-18 05:17:36

I. Introduction

Xiaohongshu MCP (xiaohongshu-mcp) is a tool for automating Xiaohongshu operations: login verification, image/video posts, comments, user profile lookup, and more. Compared with building from source or Docker, downloading a prebuilt package is fastest—no dev environment setup—and beginners can get going quickly.

This post uses the package download path end‑to‑end: deploy Xiaohongshu MCP, wire it into Cursor, and show core features so you can automate Xiaohongshu content management.

II. Preparation

2.1 System environment

Supported OS (download the matching build):

• macOS: Apple Silicon (arm64) / Intel (amd64)
• Windows: x64 (Windows 10/11)
• Linux: x64

2.2 Required dependencies (only two)

(1) Node.js (for MCP connection checks)

On every OS, install Node.js LTS the recommended way so PATH is set automatically:

• Windows: open an elevated command prompt and run:

  winget install OpenJS.NodeJS.LTS
  

• macOS/Linux: install LTS from the official Node.js downloads page

(2) Network

The first run downloads a headless browser (~150 MB); keep the network stable. Later runs won’t repeat the download.

2.3 Download the Xiaohongshu MCP package

1. Open the xiaohongshu-mcp GitHub Releases page.
2. Pick the zip for your system:
   • Windows x64: xiaohongshu-mcp-windows-amd64.zip
   • macOS Apple Silicon: xiaohongshu-mcp-darwin-arm64.zip
   • macOS Intel: xiaohongshu-mcp-darwin-amd64.zip
   • Linux x64: xiaohongshu-mcp-linux-amd64.zip
3. Unzip anywhere (avoid Chinese characters or spaces in the path, e.g. D:\xiaohongshu-mcp or /Users/yourname/xiaohongshu-mcp).

Note: cookies.json only appears after login; right after unzip you’ll only have the two files circled in the screenshot.

III. Deploy the Xiaohongshu MCP service

3.1 Unzip and verify layout

After unzip you should see two core files (Windows example):

• xiaohongshu-login-windows-amd64.exe: login tool (run this first)
• xiaohongshu-mcp-windows-amd64.exe: main MCP server

Other OS names: macOS uses xiaohongshu-login-darwin-arm64 / xiaohongshu-mcp-darwin-arm64; Linux uses xiaohongshu-login-linux-amd64 / xiaohongshu-mcp-linux-amd64.

3.2 Run the login tool

The MCP server needs cookies from a successful login:

1. Open a terminal in the unzip folder:
   • Windows: right‑click empty area → “Open in Terminal”
   • macOS/Linux: cd /path/to/xiaohongshu-mcp
2. Run the login tool:
   • Windows:

     ./xiaohongshu-login-windows-amd64.exe
     

   • macOS/Linux:

     chmod +x xiaohongshu-login-darwin-arm64  # first time only
     ./xiaohongshu-login-darwin-arm64
     

3. Login flow:
   • Headless browser downloads automatically (wait patiently);
   • Xiaohongshu login UI appears (QR or phone);
   • On success the terminal shows “login successful” and writes cookies.json in the current directory—do not delete it.

Important: Xiaohongshu does not allow many simultaneous web sessions. After logging in here, don’t log in to the same account in another browser, or you’ll be kicked offline (the mobile app is unaffected).

3.3 Start the main MCP service

After login, start the server from the same terminal:

• Windows:

  # Headless (no browser UI—recommended for normal use)
  ./xiaohongshu-mcp-windows-amd64.exe
  
  # Non-headless (visible browser—for debugging)
  ./xiaohongshu-mcp-windows-amd64.exe -headless=false
  

• macOS/Linux:

  chmod +x xiaohongshu-mcp-darwin-arm64  # first time only
  # headless
  ./xiaohongshu-mcp-darwin-arm64
  # non-headless
  ./xiaohongshu-mcp-darwin-arm64 -headless=false
  

Success: no errors in the terminal and a line like “MCP service started, port: 18060” (default 18060—don’t bind something else there).

3.4 Verify the MCP service

npx @modelcontextprotocol/inspector

In the top‑left Transport Type dropdown, change STDIO to Streamable HTTP;
a URL field appears—enter http://localhost:18060/mcp;
click Connect on the left.
Success: Connected shows at the bottom left.

Click List Tools in the center;
the middle pane lists all Xiaohongshu MCP tools/capabilities.

IV. Connect Cursor

Cursor speaks MCP—after wiring it in you can call every Xiaohongshu MCP capability with natural language, no manual HTTP.

4.1 Find Cursor’s MCP config

1. Open Cursor.
2. MCP config location:
   • Typical path: .cursor/mcp.json (Settings → MCP, or create under project root).

4.2 Configure the connection

Create or edit .cursor/mcp.json:

{
    "mcpServers": {
        "xiaohongshu-mcp": {
            "url": "http://localhost:18060/mcp",
            "description": "Xiaohongshu publishing service - MCP Streamable HTTP"
        }
    }
}

Save and restart Cursor.

4.3 Verify Cursor ↔ MCP

1. Open a new chat in Cursor.
2. Type: Check Xiaohongshu MCP login status.
3. If it returns that the account is logged in, the integration works.

V. Hands-on in Cursor

5.1 Check login status

Check my Xiaohongshu login status

You’ll get logged‑in / not logged‑in. If not logged in, run the login tool again.

5.2 Publish an image-text post

Step 1: assets

• Images: put files under an images folder next to the MCP binaries (create if missing).
• Copy: title (≤20 Chinese chars rule on platform) + body (≤1000) + hashtags (optional).

Step 2: command in Cursor

@xiaohongshu-mcp Publish a Xiaohongshu image post.  Title: “MCP setup guide for beginners”.  Body: “No source build—download the package and deploy Xiaohongshu MCP, plus full Cursor wiring.”  Image absolute path: /Users/yourname/xiaohongshu-mcp/images/cover.jpg.  Tags: #MCP #XiaohongshuAutomation #Cursor

Notes:

• Use absolute image paths (Windows example: D:\xiaohongshu-mcp\images\cover.jpg).
• Respect Xiaohongshu length limits for title and body.

Step 3: result

Cursor shows progress; when done, check the note in the Xiaohongshu app.

5.3 Other common calls

• Publish video:

  @xiaohongshu-mcp Publish a Xiaohongshu video. Title: “MCP deploy demo”. Body: “Step‑by‑step Xiaohongshu MCP.” Video path: /Users/yourname/xiaohongshu-mcp/videos/demo.mp4
  

• User profile:

  @xiaohongshu-mcp Get Xiaohongshu profile for user ID 123456
  

• Comment:

  @xiaohongshu-mcp Comment on Xiaohongshu note ID 741852: “Super helpful tutorial!”
  

VI. FAQ

Issue 1: no window / browser download fails

• Cause: network or permissions.
• Fix:
  1. Ensure outbound internet; switch networks if needed.
  2. Windows: run terminal as admin; macOS/Linux: chmod +x filename.

Issue 2: Cursor cannot connect to MCP

• Cause: server not running, port taken, or wrong URL in config.
• Fix:
  1. Confirm the MCP process is up (port 18060).
  2. mcp.json URL must be http://localhost:18060/mcp.
  3. Check 18060: Windows netstat -ano | findstr 18060; macOS/Linux lsof -i:18060—kill the conflicting process.

Issue 3: “image path error” when publishing

• Cause: relative path or wrong folder.
• Fix:
  1. Use absolute paths (e.g. D:\xiaohongshu-mcp\images\test.jpg).
  2. File must exist; avoid Chinese/space issues if your toolchain is picky.

Issue 4: kicked offline

• Cause: same account logged in elsewhere on the web.
• Fix:
  1. Log out other web sessions.
  2. Re-run the login tool to refresh cookies.

VII. Summary

With the prebuilt package you skip heavy setup (Go, Docker, etc.) and can deploy in ~10 minutes. In Cursor, natural language drives login checks, posts, video, comments, and more.

⚠️ Risk: use only for learning and legitimate personal operations; don’t abuse. When cookies expire, log in again—normal use shouldn’t ban your account.

If stuck, see the xiaohongshu-mcp README or open a GitHub Issue.