Logo
3 mins read

Windows 下使用 xiaohongshu-mcp：从登录到发布

基于官方 README 的 Windows 使用指南，包含下载、登录、启动、验证与客户端接入。

#MCP #Windows #小红书 #工具
Windows 下使用 xiaohongshu-mcp：从登录到发布

项目简介h2

xiaohongshu-mcp 是一个面向小红书的 MCP 服务，提供登录、发布图文/视频、搜索、获取详情和用户主页等能力，可接入 Claude Code、Cursor、VSCode 等支持 MCP 的客户端。

适用场景

  • 需要用 AI 自动化运营小红书内容
  • 需要批量发布或检索内容

使用前注意

  • 标题不超过 20 个字，正文不超过 1000 字
  • 同一账号不要同时在多个网页端登录，避免被踢下线
  • 先阅读 README 的疑难杂症列表，遇到问题优先排查

Windows 快速开始（推荐二进制）h2

  1. 从 GitHub Releases 下载：
    • xiaohongshu-mcp-windows-amd64.exe
    • xiaohongshu-login-windows-amd64.exe
  2. 放到同一目录（例如 D:\tools\xiaohongshu-mcp）
Terminal window
# 1) 先登录（首次必须）
.\xiaohongshu-login-windows-amd64.exe


# 2) 启动 MCP 服务（默认无头）
.\xiaohongshu-mcp-windows-amd64.exe


# 需要可视化浏览器时
.\xiaohongshu-mcp-windows-amd64.exe -headless=false

首次运行会自动下载无头浏览器（约 150MB），请确保网络畅通。服务默认地址：http://localhost:18060/mcp。

验证 MCP 是否可用h2

Terminal window
npx @modelcontextprotocol/inspector

打开命令行提示的本地地址，在 Inspector 中填入 http://localhost:18060/mcp，点击 Connect，再点 List Tools 查看工具列表。

客户端接入示例h2

Claude Code CLIh3

Terminal window
claude mcp add --transport http xiaohongshu-mcp http://localhost:18060/mcp
claude mcp list

Cursor（项目级）h3

在项目根目录新建 .cursor/mcp.json：

{
  "mcpServers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "description": "小红书内容发布服务 - MCP Streamable HTTP"
    }
  }
}

VSCode（工作区）h3

在项目根目录新建 .vscode/mcp.json：

{
  "servers": {
    "xiaohongshu-mcp": {
      "url": "http://localhost:18060/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

使用 MCP 发布图文（示例）h2

以下示例基于 Claude Code 的对话调用思路，重点是准备好标题、正文和图片路径（建议本地绝对路径）。标题不超过 20 个字，正文不超过 1000 字。

示例输入

帮我发布一篇关于周末日落的图文到小红书，
标题：日落在窗边
正文：今天的天空很温柔，记录一份安静的晚霞。
图片：D:\Pictures\sunset.webp
使用 xiaohongshu-mcp 进行发布

工具参数要点

  • title: 不超过 20 个字
  • content: 不超过 1000 字
  • images: 本地绝对路径数组（推荐）

常见问题与提示h2

  • Windows 部署遇到问题，优先查看官方 Windows 安装指南 和 疑难杂症
  • Docker 环境访问地址请改为 http://host.docker.internal:18060/mcp
  • 如果本机无法连接，请使用本机 IPv4 地址测试
  • 图片路径尽量使用本地绝对路径，且避免中文字符

参考h2