MCP 服务器

xhs-mcp-light

A lightweight MCP server that lets AI assistants publish notes to Xiaohongshu (Little Red Book) via browser automation. Supports login, image-text note publishing with up to 9 images, and search.

README

🚀 小红书 MCP Server — 轻量版

一个文件。四个工具。让你的 AI 直接发小红书。

中文 MCP 生态最轻量的小红书发布工具 — 200 行代码，不依赖重型框架，Claude / Cursor / Copilot 直接操控小红书。

这是什么

一个 单文件（server.py）的 Model Context Protocol (MCP) Server，让你的 AI 助手直接发小红书：

✅ 扫码一次，长期免登（Chrome profile 持久化）
✅ 发布图文笔记：标题 + 正文 + 多图（最多 9 张）+ 话题标签
✅ 搜索笔记
✅ 检查登录状态

竞品对比：

	xhs-mcp-light (本项目)	luyike221/xiaohongshu-mcp-python
文件数	1	~10,000
子项目	0	6
核心依赖	4	30+
安装到跑通	3 分钟	30 分钟+
MCP 传输	stdio（Claude Code 原生）	HTTP（需额外起服务）

5 分钟上手

1. 安装

# 安装 uv（如果没有）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 克隆项目
git clone https://github.com/luyike221/xhs-mcp-light.git
cd xhs-mcp-light

# 安装依赖（3 个包）
uv sync

# 安装 Chromium 浏览器（首次，约 150MB）
uv run playwright install chromium

2. 接入 Claude Code

在 Claude Code 设置文件（~/.claude/settings.json）中添加：

{
  "mcpServers": {
    "xhs-publisher": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "D:/Claudecoda学习/xhs-mcp-light"
    }
  }
}

其他 AI 工具（Cursor、Copilot、Codex）的配置见 MCP 官方文档。

3. 扫码登录

重启 Claude Code，然后说：

"帮我登录小红书"

Claude 会调用 xhs_login → 弹出浏览器窗口 → 用小红书 App 扫码 → 完成。一次扫码，永久有效。

4. 发布第一篇笔记

"帮我发一篇小红书：标题'我的 AI 帮我发了这篇笔记'，内容写……，图片用桌面上的 test.jpg"

四个工具

工具	说明	必填参数
`xhs_login`	打开浏览器扫码登录	无
`xhs_check_login`	检查登录状态	无
`xhs_publish_note`	发布图文笔记	`title`, `content`, `images`
`xhs_search_feeds`	搜索笔记	`keyword`

使用示例

自然语言（推荐）

"发一篇小红书：标题'成都周末探店'，正文分享一家藏在巷子里的咖啡馆，图片用桌面的 cafe1.jpg、cafe2.jpg，标签加成都探店、咖啡馆、周末去哪"

Claude 自动翻译成工具调用，完成发布。

直接调用

xhs_publish_note(
  title="成都周末探店",
  content="藏在巷子里的惊喜...",
  images=["C:/Users/xxx/Desktop/cafe1.jpg", "C:/Users/xxx/Desktop/cafe2.jpg"],
  tags=["成都探店", "咖啡馆", "周末去哪"]
)

原理

Claude Code ──MCP stdio──▶ server.py ──Playwright──▶ Chrome ──▶ 小红书网页版
                                                          │
                                                    登录态保存在
                                                    xhs-browser-data/

不碰小红书 API（不逆向、不抓包）——模拟真人操作浏览器
Playwright persistent context 保存 Chrome profile——一次扫码，长期免登
stdio 传输——不需要起 HTTP 服务，Claude Code 直接启动子进程

文件结构

xhs-mcp-light/
├── server.py          # 全部代码（233 行）
├── pyproject.toml     # 依赖声明
├── .env.example       # 配置模板
├── xhs-browser-data/  # Chrome profile（自动生成，含登录态）
├── assets/            # 图片资源
└── README.md