social-mcp/README.zh-CN.md

Social Auto Hub（Monorepo）

English

仓库已改造为 workspace monorepo，结构上清晰拆分为：

• apps/xhs-mcp：小红书 MCP 服务（xhs_*）
• apps/xhh-mcp：小黑盒 MCP 服务（xhh_*）
• packages/core：共享基础设施（browser/config/cookie/server/utils）

目录结构

apps/
  xhs-mcp/
  xhh-mcp/
packages/
  core/

快速开始

前置要求

• Node.js >= 22
• pnpm

安装依赖

pnpm install
npx rebrowser-playwright install chromium

构建全部包

pnpm build

启动小红书服务

pnpm start:xhs

默认运行参数：

• PORT=9527
• COOKIE_DIR=~/.social-mcp-xhs

启动小黑盒服务

pnpm start:xhh

默认运行参数：

• PORT=9528
• COOKIE_DIR=~/.social-mcp-xhh

根目录兼容脚本

根脚本保留为转发壳：

• pnpm build
• pnpm lint
• pnpm test
• pnpm start:xhs
• pnpm start:xhh
• pnpm dev:xhs
• pnpm dev:xhh

也可以直接按包执行：

pnpm --filter @social/core build
pnpm --filter @social/xhs-mcp start
pnpm --filter @social/xhh-mcp start

MCP 地址

• XHS MCP: http://127.0.0.1:9527/mcp
• XHH MCP: http://127.0.0.1:9528/mcp

REST 地址

• XHS REST: http://127.0.0.1:9527/api/xhs/*
• XHH REST: http://127.0.0.1:9528/api/xhh/*

两个服务使用各自 COOKIE_DIR 下的独立 Bearer token。

Claude Desktop 接入示例

{
  "mcpServers": {
    "mcp-xhs": {
      "url": "http://127.0.0.1:9527/mcp"
    },
    "mcp-xhh": {
      "url": "http://127.0.0.1:9528/mcp"
    }
  }
}

Docker

单一 Dockerfile 支持通过 APP_NAME 构建双目标：

• APP_NAME=xhs-mcp
• APP_NAME=xhh-mcp

docker-compose.yml 和 deploy/docker-compose.yml 已配置双服务。

迁移说明

• 旧的根入口（src/index.ts）已移除。
• 服务代码迁移到 apps/*。
• 共享基础能力迁移到 packages/core。
• 锁文件策略改为 pnpm（pnpm-lock.yaml）。