关键词

小红书内容发布自动化AI工具集成社交媒体发布

项目简介

这是一个实现了 Model Context Protocol (MCP) 规范的服务器应用。它作为小红书平台和支持MCP协议的大模型（如Claude、Zed等）之间的桥梁，使大模型能够通过标准化的方式调用小红书的发布、查询等功能。

主要功能点

  • 自动发布笔记: 支持发布纯文本、图文（支持本地和URL图片）和视频笔记到小红书平台。
  • 话题标签支持: 发布时可添加话题标签。
  • 账号管理: 通过扫码方式登录小红书账号，自动管理登录状态和Cookie。
  • 登录状态检查: 提供工具查询当前小红书账号的登录状态。
  • 资源访问: 提供访问特定笔记和当前用户信息的接口（作为MCP资源）。
  • 自动化与AI集成: 设计用于与大模型应用无缝集成，实现小红书内容的自动化生成和发布。

安装步骤

本项目推荐使用 pip 进行安装：

  1. 确保环境: 需要 Python 3.11 或更高版本。
  2. 通过 pip 安装:
    • 安装基础功能： 
      pip install mcp-xhs-publisher
    • 推荐安装，包含 MCP SDK： 
      pip install "mcp-xhs-publisher[mcp]"

服务器配置

作为MCP服务器，它通常不是直接手动运行的，而是由支持MCP协议的客户端（如AI编辑器、聊天机器人等）启动。客户端需要配置一个JSON对象来定义如何启动这个服务器。

典型的客户端配置需要指定：

  • 'name': 服务器的唯一标识名称，例如 'xhs-publisher'。
  • 'command': 启动服务器的可执行命令，通常是 'uvx' 或 'python -m' 加上项目模块名，例如 'uvx'。
  • 'args': 传递给启动命令的参数列表，例如 '["mcp-xhs-publisher"]'。

此外，服务器支持通过环境变量进行配置，这些配置会在服务器启动时被读取：

  • 'MCP_LOG_LEVEL': 设置日志级别（如 DEBUG, INFO, WARNING, ERROR）。
  • 'XHS_COOKIE_DIR': 指定存储小红书账号Cookie的目录路径。
  • 'XHS_SIGN_URL': 如果使用需要签名的小红书API，需要提供签名服务的URL。

示例（客户端配置中 env 字段的内容）：

{
  "MCP_LOG_LEVEL": "INFO",
  "XHS_COOKIE_DIR": "~/.xhs_cookies",
  "XHS_SIGN_URL": "https://example.com/your-sign-service"
}

(注：具体的客户端配置方式请参考您使用的AI应用或工具的MCP服务器配置文档)

基本使用方法

  1. 配置客户端: 在您支持MCP协议的AI应用或工具中，按照其说明添加并配置 '小红书发布 MCP 服务器'。配置时指定服务器的启动命令和必要的环境变量（如Cookie存储路径和签名服务URL）。
  2. 启动服务器: 当您在客户端中与需要小红书功能的AI互动时，客户端会自动启动并连接到配置好的MCP服务器。
  3. 扫码登录: 服务器首次使用或Cookie失效时，会提示您使用小红书APP扫描终端或日志中显示的二维码进行登录。请根据提示完成登录流程。
  4. AI调用功能: 一旦服务器成功启动并登录，您就可以在AI应用中通过对话或特定指令，让大模型调用服务器提供的发布、查询等工具和资源。例如，您可以告诉AI“帮我把这张图片和这段文字发布到小红书”，AI会识别您的意图并调用对应的MCP工具。
  5. 查看结果: 工具执行结果（如发布是否成功、笔记ID等）会通过MCP协议返回给客户端，通常会由AI应用展示给您。

信息

分类

生产力应用

访问项目