┌─────────────────────────────────────────────────────────────────┐
│                        系统架构总览                              │
└─────────────────────────────────────────────────────────────────┘

    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
    │   AI客户端群    │    │   API网关层     │    │   小红书平台     │
    │ Claude/Cursor   │◄──►│  Express+MCP    │◄──►│  多账号并发      │
    │ VSCode/CLI工具  │    │  WebSocket      │    │  自动化操作      │
    └─────────────────┘    └─────────────────┘    └─────────────────┘
                                    │
                    ┌───────────────┼───────────────┐
                    ▼               ▼               ▼
            ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
            │ Directus    │ │   MySQL     │ │ 反风控引擎   │
            │ 管理后台    │ │  数据中心   │ │ Stealth+    │
            │ (零配置)    │ │ (统一前缀)  │ │ Fingerprint │
            └─────────────┘ └─────────────┘ └─────────────┘
                    │               │               │
                    └───────────────┼───────────────┘
                              ▼
            ┌─────────────────────────────────────────────────┐
            │              浏览器实例池                        │
            │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
            │ │ 账号1+代理A │ │ 账号2+代理B │ │ 账号N+代理N │ │
            │ │ 指纹集A     │ │ 指纹集B     │ │ 指纹集N     │ │
            │ └─────────────┘ └─────────────┘ └─────────────┘ │
            └─────────────────────────────────────────────────┘

# 克隆项目
git clone https://github.com/ToDieOrNot/xiaohongshu-mcp-nodejs.git
cd xiaohongshu-mcp-nodejs

# 安装依赖
npm install

# 创建数据库
mysql -u root -p
CREATE DATABASE xiaohongshu_mcp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 运行数据库迁移
npm run db:migrate

# 复制环境变量模板
cp .env.example .env

# 编辑配置文件
vim .env

# 开发模式
npm run dev

# 生产模式
npm start

# MySQL数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_NAME=xiaohongshu_mcp
DB_USER=root
DB_PASSWORD=your_password

# Redis缓存配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

# 浏览器配置
BROWSER_HEADLESS=true
BROWSER_TIMEOUT=30000
BROWSER_MAX_CONCURRENCY=5

# 代理配置
PROXY_ENABLED=true
PROXY_CHECK_INTERVAL=300000
PROXY_TIMEOUT=10000

# 指纹配置
FINGERPRINT_ENABLED=true
FINGERPRINT_CACHE_SIZE=1000

# MCP服务器配置
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=3000
MCP_WEBSOCKET_PORT=3001

# 任务配置
TASK_MAX_CONCURRENCY=10
TASK_RETRY_ATTEMPTS=3
TASK_RETRY_DELAY=2000

GET    /api/accounts           # 获取账号列表
POST   /api/accounts           # 创建账号
PUT    /api/accounts/:id       # 更新账号
DELETE /api/accounts/:id       # 删除账号

GET    /api/tasks              # 获取任务列表
POST   /api/tasks              # 创建任务
PUT    /api/tasks/:id/cancel   # 取消任务
GET    /api/tasks/:id          # 获取任务详情

GET    /api/search             # 搜索内容
GET    /api/posts/:id          # 获取笔记详情
GET    /api/users/:id          # 获取用户信息
GET    /api/comments           # 获取评论
GET    /api/trending           # 获取热门内容

// MCP协议调用
const result = await client.call('xiaohongshu.create_account', {
  username: 'test_user',
  phone: '13800138000',
  proxy_id: 1,
  fingerprint_id: 1
});

// REST API调用
const response = await fetch('/api/accounts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    username: 'test_user',
    phone: '13800138000',
    proxy_id: 1,
    fingerprint_id: 1
  })
});

// MCP协议调用
const results = await client.call('xiaohongshu.search_content', {
  keyword: '美妆',
  account_id: 1,
  limit: 20,
  sort: 'latest'
});

// REST API调用
const response = await fetch('/api/search?keyword=美妆&account_id=1&limit=20&sort=latest');

// MCP协议调用
const result = await client.call('xiaohongshu.publish_post', {
  account_id: 1,
  title: '测试笔记',
  content: '这是测试内容',
  images: ['image1.jpg', 'image2.jpg'],
  tags: ['测试', '美妆']
});

// REST API调用
const response = await fetch('/api/posts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    account_id: 1,
    title: '测试笔记',
    content: '这是测试内容',
    images: ['image1.jpg', 'image2.jpg'],
    tags: ['测试', '美妆']
  })
});

version: '3.8'
services:
  xiaohongshu-mcp:
    build: .
    ports:
      - "3000:3000"
      - "3001:3001"
    environment:
      - NODE_ENV=production
    volumes:
      - ./data:/app/data
    depends_on:
      - mysql
      - redis

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: xiaohongshu_mcp
    volumes:
      - mysql_data:/var/lib/mysql

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data

volumes:
  mysql_data:
  redis_data:

# 构建并启动
docker-compose up -d

# 查看日志
docker-compose logs -f xiaohongshu-mcp

GET /health