xiaohongshu-mcp MCP工具

🚀 快速开始：选择最适合你的版本

[!IMPORTANT] #### 🔥 方案 A：Openclaw 深度集成 (推荐给开发者) - Openclaw 太火啦 🔥🔥🔥 ，新增 Openclaw 支持，分为两种，请各位按需使用： - xiaohongshu-mcp-skills（适用于已部署完本项目的用户） - xiaohongshu-skills（开箱即用版）

[!TIP] #### ✨ 方案 B：x-mcp 浏览器插件版 (推荐给非技术同学 / 追求极简的用户) - 不想折腾 Docker 或部署环境？试试：xpzouying/x-mcp - 零配置：安装插件即用，无需任何代码、代理或复杂的环境配置。 - 安全稳定：直接在常用浏览器 (Chrome/Edge) 及本地网络运行，无服务器 IP 风险，且能解决 90% 的部署报错。

1.1. 快速开始（推荐）

方式一：下载预编译二进制文件

直接从 GitHub Releases 下载对应平台的二进制文件：

主程序（MCP 服务）：

• macOS Apple Silicon: xiaohongshu-mcp-darwin-arm64
• macOS Intel: xiaohongshu-mcp-darwin-amd64
• Windows x64: xiaohongshu-mcp-windows-amd64.exe
• Linux x64: xiaohongshu-mcp-linux-amd64

登录工具：

• macOS Apple Silicon: xiaohongshu-login-darwin-arm64
• macOS Intel: xiaohongshu-login-darwin-amd64
• Windows x64: xiaohongshu-login-windows-amd64.exe
• Linux x64: xiaohongshu-login-linux-amd64

使用步骤：

```bash

下载 docker-compose.yml

wget https://raw.githubusercontent.com/xpzouying/xiaohongshu-mcp/main/docker/docker-compose.yml

或者如果已经克隆了项目，进入 docker 目录

cd docker

2.1. 快速开始

启动 MCP 服务

```bash

1. 使用教程

1. 首先运行登录工具

chmod +x xiaohongshu-login-darwin-arm64 ./xiaohongshu-login-darwin-arm64

2. 然后启动 MCP 服务

chmod +x xiaohongshu-mcp-darwin-arm64 ./xiaohongshu-mcp-darwin-arm64

**⚠️ 重要提示**：首次运行时会自动下载无头浏览器（约 150MB），请确保网络连接正常。后续运行无需重复下载。

**方式二：源码编译**

<details>
<summary>源码编译安装详情</summary>

依赖 Golang 环境，安装方法请参考 [Golang 官方文档](https://go.dev/doc/install)。

设置 Go 国内源的代理，

启动服务

docker compose up -d

在项目根目录运行

docker build -t xpzouying/xiaohongshu-mcp . ```

4. 配置说明

Docker 版本会自动：

• 配置 Chrome 浏览器和中文字体
• 挂载 ./data 用于存储 cookies
• 挂载 ./images 用于存储发布的图片
• 暴露 18060 端口供 MCP 连接

详细使用说明请参考：Docker 部署指南

</details>

Windows 遇到问题首先看这里：Windows 安装指南

运行对应平台的登录工具

./xiaohongshu-login-darwin-arm64

**使用源码**：

1.3. 启动 MCP 服务

启动 xiaohongshu-mcp 服务。

使用二进制文件：

```bash

设置代理后启动

XHS_PROXY=http://user:pass@proxy:port ./xiaohongshu-mcp-darwin-arm64

或使用源码

XHS_PROXY=http://proxy:port go run . ```

支持 HTTP/HTTPS/SOCKS5 代理，日志中会自动隐藏代理的认证信息。

1.5. 使用 MCP 发布

启动服务（默认无头模式）

go run .

检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）

claude mcp list ```

检查 MCP 是否添加成功（确保 MCP 已经启动的前提下，运行下面命令）

claude mcp list

</details>

<details>
<summary><b>Open Code CLI</b></summary>

使用交互式命令添加 MCP Server：

以添加 `xiaohongshu-mcp` 为例：

验证是否添加成功（确保 MCP 已启动的前提下）：

</details>

<details>
<summary><b>Cursor</b></summary>

#### 配置文件的方式

创建或编辑 MCP 配置文件：

**项目级配置**（推荐）：
在项目根目录创建 `.cursor/mcp.json`：

**全局配置**：
在用户目录创建 `~/.cursor/mcp.json` (同样内容)。

#### 使用步骤

1. 确保小红书 MCP 服务正在运行
2. 保存配置文件后，重启 Cursor
3. 在 Cursor 聊天中，工具应该自动可用
4. 可以通过聊天界面的 "Available Tools" 查看已连接的 MCP 工具

**Demo**

插件 MCP 接入：

![cursor_mcp_settings](./assets/cursor_mcp_settings.png)

调用 MCP 工具：（以检查登录状态为例）

![cursor_mcp_check_login](./assets/cursor_mcp_check_login.png)

</details>

<details>
<summary><b>VSCode</b></summary>

#### 方法一：使用命令面板配置

1. 按 `Ctrl/Cmd + Shift + P` 打开命令面板
2. 运行 `MCP: Add Server` 命令
3. 选择 `HTTP` 方式。
4. 输入地址： `http://localhost:18060/mcp`，或者修改成对应的 Server 地址。
5. 输入 MCP 名字： `xiaohongshu-mcp`。

#### 方法二：直接编辑配置文件

**工作区配置**（推荐）：
在项目根目录创建 `.vscode/mcp.json`：

**查看配置**：

![vscode_config](./assets/vscode_mcp_config.png)

1. 确认运行状态。
2. 查看 `tools` 是否正确检测。

**Demo**

以搜索帖子内容为例：

![vscode_mcp_search](./assets/vscode_search_demo.png)

</details>

<details>
<summary><b>Google Gemini CLI</b></summary>

在 `~/.gemini/settings.json` 或项目目录 `.gemini/settings.json` 中配置：

更多信息请参考 [Gemini CLI MCP 文档](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)

</details>

<details>
<summary><b>MCP Inspector</b></summary>

调试工具，用于测试 MCP 连接：

启动 MCP Inspector

npx @modelcontextprotocol/inspector

2.4. 使用示例

使用 Claude Code 发布内容到小红书：

示例 1：使用 HTTP 图片链接

帮我写一篇帖子发布到小红书上，
配图为：https://cn.bing.com/th?id=OHR.MaoriRock_EN-US6499689741_UHD.jpg&w=3840
图片是："纽西兰陶波湖的Ngātoroirangi矿湾毛利岩雕（© Joppi/Getty Images）"

使用 xiaohongshu-mcp 进行发布。

示例 2：使用本地图片路径（推荐）

帮我写一篇关于春天的帖子发布到小红书上，
使用这些本地图片：
- /Users/username/Pictures/spring_flowers.jpg
- /Users/username/Pictures/cherry_blossom.jpg

使用 xiaohongshu-mcp 进行发布。

示例 3：发布视频内容

帮我写一篇关于美食制作的视频发布到小红书上，
使用这个本地视频文件：
- /Users/username/Videos/cooking_tutorial.mp4

使用 xiaohongshu-mcp 的视频发布功能。

发布结果：

<img src="./assets/publish_result.jpeg" alt="xiaohongshu-mcp 发布结果" width="300">

📚 完整教程列表

1. n8n 完整集成教程 - 工作流自动化平台集成
2. Cherry Studio 完整配置教程 - AI 客户端完美接入
3. Claude Code + Kimi K2 接入教程 - Claude Code 门槛太高，那么就接入 Kimi 国产大模型吧～
4. AnythingLLM 完整指南 - AnythingLLM 是一款 all-in-one 多模态 AI 客户端，支持 workflow 定义，支持多种大模型和插件扩展。

🎯 提示: 点击上方链接查看详细的图文教程，快速上手各种集成方案！ 📢 欢迎贡献: 如果你有新的集成案例，欢迎提交 PR 分享给社区！

3. 🌟 实战案例展示 (Community Showcases)

💡 强烈推荐查看：这些都是社区贡献者的真实使用案例，包含详细的配置步骤和实战经验！

配置 GOPROXY 环境变量，以下三选一

2.5. 💬 MCP 使用常见问题解答

---

⚠️ 以下是使用 OpenClaw + MCPorter 时的已知风险，使用前请充分了解：

• OpenClaw 的 AI 自动部署行为不在本项目的维护范围内，部署结果无法保证
• MCPorter 作为中间层可能引入额外的兼容性问题，与 xiaohongshu-mcp 本身无关
• 若遇到连接失败、工具调用异常等问题，请先排查 MCPorter 自身的配置，而非提交 Issue
• 在提问社区或群组前，请先确认问题是否能在不使用 OpenClaw 的情况下复现

如果你没有强烈的 OpenClaw 使用需求，强烈建议改用 Claude Code CLI、Cursor 或 Cline 等原生支持 HTTP MCP 的客户端，体验会更稳定。

---

Q: 为什么检查登录用户名显示 xiaghgngshu-mcp？ A: 用户名是写死的。

---

Q: 显示发布成功后，但实际上没有显示？ A: 排查步骤如下：

1. 使用 非无头模式 重新发布一次。
2. 更换 不同的内容 重新发布。
3. 登录网页版小红书，查看账号是否被 风控限制网页版发布。
4. 检查 图片大小 是否过大。
5. 确认 图片路径中没有中文字符。
6. 若使用网络图片地址，请确认 图片链接可正常访问。

---

Q: 在设备上运行 MCP 程序出现闪退如何解决？ A:

1. 建议 从源码安装。 2. 或使用 Docker 安装 xiaohongshu-mcp，教程参考： - 使用 Docker 安装 xiaohongshu-mcp - X-MCP 项目页面

---

Q: 使用 http://localhost:18060/mcp 进行 MCP 验证时提示无法连接？ A:

- 在 Docker 环境 下，请使用 👉 http://host.docker.internal:18060/mcp - 在 非 Docker 环境 下，请使用 本机 IPv4 地址 访问。

---