小红书智能对话桌面应用

基于Electron的桌面应用,集成小红书MCP服务和LLM Agent,提供智能对话和自动化操作能力。

  • by hg-tc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hg-tc/desktop_mcp

使用说明

小红书 Agent 桌面应用

基于 Electron 的桌面应用,集成小红书 MCP 服务和 LLM Agent,提供智能对话和自动化操作能力。

项目简介

这是一个桌面应用,集成了:

  • 小红书 MCP 服务:提供小红书平台的自动化操作(搜索、发布、点赞等)
  • LLM Agent:通过大语言模型理解用户意图,自动调用 MCP 工具完成任务
  • 流式响应:实时显示 AI 回复,提升用户体验

技术架构

  • 前端:Electron + React + TypeScript
  • 后端服务:
    • Go 后端:小红书 MCP 服务(HTTP + MCP 协议)
    • Python 后端:LLM 服务(WebSocket 流式响应)

详见 STRUCTURE.md 和 desktop/electron/ARCHITECTURE.md

快速开始

环境要求

  • Node.js 18+
  • Python 3.10+
  • Go 1.21+(用于构建 Go 后端)

安装依赖

  1. 安装 Node.js 依赖
cd desktop/electron
npm install
  1. 安装 Python 依赖
cd backend/python
pip install -r requirements.txt

开发运行

cd desktop/electron
npm run dev

这将启动:

  • Electron 应用
  • Go 后端服务(自动启动)
  • Python LLM 后端服务(自动启动)

构建应用

cd desktop/electron
npm run build

构建产物在 desktop/electron/release/ 目录。

配置说明

LLM 配置

首次运行需要在设置中配置:

  • API Key:你的 LLM API Key(如 DeepSeek、OpenAI 等)
  • Base URL:API 服务地址
  • Model:模型名称(如 deepseek-chat)

登录小红书

应用启动后,点击"打开浏览器登录"按钮,在浏览器中完成小红书登录。登录状态会自动保存。

功能特性

  • ✅ 智能对话:通过 LLM 理解自然语言,自动执行操作
  • ✅ 工具调用:自动识别需要调用的小红书操作工具
  • ✅ 流式响应:实时显示 AI 回复,打字机效果
  • ✅ 登录管理:自动保存和管理登录状态
  • ✅ 跨平台:支持 Windows、macOS、Linux

项目结构

xiaohongshu-mcp-main/
├── backend/              # 后端服务
│   ├── go/              # Go 后端(小红书 MCP)
│   └── python/           # Python 后端(LLM 服务)
├── desktop/
│   └── electron/         # Electron 桌面应用
└── docs/                 # 文档

详见 STRUCTURE.md

开发文档

许可证

MIT License