📕 xhs-mcp — 샤오홍슈를 나의 MCP 도구로

로컬 실행 · Chrome 구동 · 부계정 안전 — 샤오홍슈 ⇌ 모든 MCP 호스트(DSH 우선)

가벼운 MCP Server로, DSH / Claude / Cursor 등 호스트에서 **비공개 채팅/도구 호출**을 통해 샤오홍슈를 조작할 수 있습니다: 로그인, 노트 검색! (발행 기능은 예약되어 있으며, 주인의 명시적 승인이 필요합니다)

✨ 기능

Related MCP server: Xiaohongshu (RedBook) MCP Server

🚀 빠른 시작(DSH 우선)

사전 준비

• Node.js ≥ 20

• **Google Chrome 설치됨)(또는 경로 지정)**

1️⃣ 다운로드

git clone https://github.com/HUliangwei/xhs-mcp.git
cd xhs-mcp
npm install          # 安装 playwright-core

2️⃣ 설정

cp .env.example .env
# 按需改 XHS_PROFILE（多账号用不同名）

3️⃣ DSH에 등록

dsh-bundle/을 프로필 번들에 복사하고, 프로필의 package.json dsh.profile.bundles에 ./bundles/xhs-mcp를 추가하세요:

{ "dsh": { "profile": { "bundles": [ "./bundles/xhs-mcp" ] } } }

DSH 재시작 → 도구 그룹 xhs_* 사용 가능.

4️⃣ 기타 호스트

{ "mcpServers": { "xhs": { "command": "node", "args": ["<路径>/xhs-mcp-server.mjs"] } } }

🛠️ 도구

🛡️ 보안 설계

• **비공개 채팅/도구 호출만: 어떤 그룹 채팅 브로드캐스트에도 연결하지 않음**

• **부계정 전용: 독립 profile, 로그인 상태 격리, 주인의 메인 계정에 접촉하지 않음**

• **읽기 전용 우선: 현재 읽기 전용+검색; 발행은 주인의 명시적 승인 필요, 저빈도 준수**

• **로컬 실행: 원격 서버 없음, 데이터가 본 기기를 벗어나지 않음**

• **git에 포함 안 함: profiles/(로그인 상태), .env 모두 무시**

📜 오픈소스

Apache-2.0 · GitHub

**유용하다고 생각하시나요? ⭐ Star!!**