小红书MCP服务器 - Node.js版本

基于现代化Node.js技术栈的小红书MCP（Model Context Protocol）服务器，提供企业级多账号矩阵管理和反风控功能。

🌟 核心特性

🔐 多账号管理

• 无限账号支持：支持无限数量的小红书账号管理
• 独立环境：每个账号使用独立的浏览器指纹和代理环境
• 状态监控：实时监控账号登录状态和健康状况
• Cookie管理：自动维护登录状态，支持Cookie持久化

🛡️ 反风控系统

• 浏览器指纹伪造：完整的UA、硬件、地理位置模拟
• 行为模拟：智能鼠标轨迹、键盘输入、页面滚动
• 特征清理：移除WebDriver、CDP等自动化检测特征
• 代理轮换：支持HTTP/SOCKS5代理池，智能轮换

🚀 任务调度

• 并发执行：支持多任务并发执行，可配置并发数
• 定时任务：基于Cron表达式的定时任务调度
• 重试机制：智能重试和失败恢复
• 任务监控：实时任务状态追踪和历史记录

📊 数据采集

• 内容搜索：关键词搜索、话题搜索、用户搜索
• 笔记详情：获取完整的笔记内容和互动数据
• 用户信息：获取用户基本信息和统计数据
• 评论采集：获取笔记评论和互动信息
• 热门内容：获取各分类热门内容

🎛️ 管理后台

• Web界面：基于Express.js的现代化管理界面
• 实时监控：实时任务状态、系统资源监控
• 数据可视化：图表展示账号数据、任务统计
• 配置管理：可视化配置代理、指纹、任务参数

🏗️ 技术架构

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

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

🛠️ 技术栈

• 运行时环境: Node.js 18+ LTS
• 浏览器自动化: Playwright + playwright-stealth + ghost-cursor
• 数据库: MySQL 8.0+ (统一表前缀: idea_xiaohongshu_)
• 缓存: Redis 7.0+
• 任务调度: Bull Queue + node-cron
• Web框架: Express.js + Socket.IO
• MCP协议: JSON-RPC 2.0 标准实现
• 管理后台: Directus CMS

📦 快速开始

1. 环境准备

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

# 安装依赖
npm install

2. 数据库配置

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

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

3. 环境配置

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

# 编辑配置文件
vim .env

4. 启动服务

# 开发模式
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服务器配置
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

📋 API接口

MCP协议接口

账号管理

• xiaohongshu.create_account - 创建账号
• xiaohongshu.get_accounts - 获取账号列表
• xiaohongshu.update_account - 更新账号信息
• xiaohongshu.delete_account - 删除账号

任务管理

• xiaohongshu.create_task - 创建任务
• xiaohongshu.get_tasks - 获取任务列表
• xiaohongshu.cancel_task - 取消任务
• xiaohongshu.get_task_status - 获取任务状态

内容操作

• xiaohongshu.search_content - 搜索内容
• xiaohongshu.get_post_info - 获取笔记详情
• xiaohongshu.get_user_info - 获取用户信息
• xiaohongshu.get_comments - 获取评论
• xiaohongshu.get_trending - 获取热门内容

发布操作

• xiaohongshu.publish_post - 发布笔记
• xiaohongshu.schedule_post - 定时发布笔记
• xiaohongshu.get_drafts - 获取草稿列表

RESTful API

账号管理

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           # 获取热门内容

🎯 使用示例

1. 创建账号

// 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
  })
});

2. 搜索内容

// 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');

3. 发布笔记

// 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: ['测试', '美妆']
  })
});

🐳 Docker部署

使用Docker Compose

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

🔍 监控和日志

日志系统

• 应用日志：使用Winston记录所有操作和错误
• 访问日志：记录所有API请求和响应
• 任务日志：记录任务执行详情和状态变化
• 浏览器日志：记录浏览器操作和网络请求

健康检查

GET /health

监控指标

• 账号登录状态
• 任务执行统计
• 系统资源使用
• 代理可用性
• 反风控效果

🚨 注意事项

合规使用

• 请遵守小红书平台的使用条款
• 不要用于恶意刷量、垃圾营销等违规操作
• 合理设置请求频率，避免对平台造成压力

安全建议

• 定期更换代理IP
• 使用高质量的代理服务
• 监控账号异常行为
• 及时更新反风控策略

性能优化

• 根据服务器配置调整并发数
• 合理设置任务重试策略
• 定期清理过期数据
• 使用CDN加速静态资源

🤝 贡献指南

1. Fork项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建Pull Request

📄 许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情。

📞 支持

• 📧 邮箱：qq164093410@gmail.com
• 💬 微信：ToDieOrNot
• 🐛 问题反馈：GitHub Issues

🙏 致谢

• Playwright - 浏览器自动化
• Bull Queue - 任务队列
• Socket.IO - 实时通信
• Directus - 管理后台

---

⭐ 如果这个项目对你有帮助，请给个Star支持一下！