项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 17200
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 系统平台:macOS Apple Silicon、Windows x64 或 Linux x64(macOS Intel 与 Linux ARM64 暂不支持)
- 首次启动需联网自动下载无头浏览器(约 150MB)
- 下载前请确认网络连接稳定
- 使用源码编译需先安装 Go 环境
- 由支持 HTTP MCP 的客户端调用(如 Claude Code、Cursor、VSCode、Cline 等)
安装与启动步骤
-
1下载预编译文件
在 GitHub Releases 页面按平台下载 MCP 主程序与登录工具两个文件,放入同一目录
-
2运行登录工具
先运行登录工具完成小红书账号登录,登录态会被保存供后续服务复用
chmod +x xiaohongshu-login-darwin-arm64 ./xiaohongshu-login-darwin-arm64 -
3启动 MCP 服务
运行主程序启动 MCP 服务,默认监听本地 18060 端口;首次启动会下载无头浏览器
chmod +x xiaohongshu-mcp-darwin-arm64 ./xiaohongshu-mcp-darwin-arm64 -
4可选启用访问鉴权
若不希望服务被随意调用,可通过 AUTH_TOKEN 环境变量设置令牌,默认不启用鉴权
AUTH_TOKEN=your-secret-token ./xiaohongshu-mcp-darwin-arm64 -
5配置 MCP 客户端
在客户端 MCP 配置中填入服务地址;Cursor 可在项目根目录新建 .cursor/mcp.json
{ "mcpServers": { "xiaohongshu-mcp": { "url": "http://localhost:18060/mcp", "description": "小红书内容发布服务 - MCP Streamable HTTP" } } } -
6确认连接成功
保存配置并重启客户端后,用命令行列出 MCP 服务,看到已连接即表示接入成功
claude mcp list
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
url | 是 | MCP 服务的 HTTP 接入地址,客户端据此连接 | http://localhost:18060/mcp |
AUTH_TOKEN | 否 | 启用服务端访问鉴权的令牌,非空启动参数优先于该环境变量 | your-secret-token |
Authorization | 否 | 启用鉴权后客户端需携带的请求头,格式为 Bearer 加令牌 | Bearer your-secret-token |
type | 否 | 部分客户端用于指定传输类型 | http |
timeout | 否 | 客户端请求超时时间,单位毫秒(Gemini CLI 配置项) | 30000 |
如何确认成功
客户端执行 claude mcp list 或 opencode mcp list,显示 xiaohongshu-mcp 已连接即表示服务启动成功。
常见问题
Q:显示发布成功但小红书上没有内容?
A:先用非无头模式重新发布一次并更换内容测试;再检查账号是否被限制网页版发布、图片是否过大、图片路径是否含中文字符、网络图片链接能否正常访问。
Q:程序运行时闪退怎么办?
A:确认系统平台在支持范围内,并检查首次运行所需的无头浏览器是否已完整下载;排查耗时较久可先查阅仓库 Issues #56 的疑难杂症汇总。
Q:客户端配置后连不上服务?
A:确认 MCP 服务已在本机启动且地址端口填写正确;若启用了 AUTH_TOKEN,还需在客户端配置中加上 Authorization: Bearer 请求头。
Q:可以用令牌启动时怎么更安全?
A:命令行参数可能被进程列表看到,部署环境建议改用 AUTH_TOKEN 环境变量传入令牌。
Q:为什么检查登录用户名显示固定名称?
A:该用户名在实现中是写死的,不代表实际登录账号,属正常现象。
注意事项
- 首次运行会自动下载约 150MB 的无头浏览器,请预留时间和磁盘空间,之后无需重复下载。
- 目前仅提供 macOS Apple Silicon、Windows x64、Linux x64 三个平台的预编译文件。
- 发布图片建议使用本地路径作为图片地址,能提升稳定性。
- 若已启用访问鉴权,所有 MCP 客户端都必须配置对应的 Authorization 请求头。
核心亮点
- 用 Go 单二进制部署,启动快、依赖少,配置 MCP 客户端即可接入
- 把搜索、读笔记、看评论、发图文封装成标准 MCP 工具,AI 可直接调用
- 基于浏览器自动化维持登录态,贴近真实用户操作路径,接入门槛低
不足之处
- 依赖浏览器自动化,平台页面结构或风控策略变化时容易失效
- 发布与抓取行为受平台规则约束,高频调用可能触发验证或限流
- 仅覆盖小红书单一平台,工具粒度和稳定性仍待长期验证
适用场景
- 内容创作者让 AI 助手调研某关键词下的热门笔记与评论风向
- 运营人员在对话中批量生成并发布图文笔记草稿
- 数据分析场景下抓取笔记详情,做选题与竞品内容分析
替代项目
mcp-server-browserbase、playwright-mcp、browser-use
下一篇:ida-pro-mcp
同类项目推荐
dsh-nekowhale-stickers
开源
给聊天机器人接入大肥鱼表情包,回复更有情绪
大肥鱼 / GPT娘 sticker knowledge kit for DeepSeek Harness (dsh), MCP and any chat bo···
everyinfra-agent-plugins
开源
给 AI 编程工具一键接入百平台数据采集
EveryInfra MCP server & agent plugin: scraper API for TikTok, Instagram, Amazon, You···
mcp-for-blender
开源
用嘴指挥 Blender 建模,说句话就改场景
Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···
skills
开源
给 AI 装上社媒运营大脑,一句话跑通内容全流程
106 social media skills for AI agents - strategy, writing, video, design, platform g···
awesome-gamedev-agent-skills
开源
给AI装上游戏引擎大脑,一键生成专业游戏代码
Make games with your AI coding agent: 79 game-dev skills and a router for Godot, Uni···
mnemory
开源
给 AI 助手装一个自托管、会自动整理事实的长期记忆库
A self-hosted, secure, feature-rich memory system for AI agents and assistants. Prov···
oryxos
开源
像管进程一样管 AI Agent,分布式调度开箱即用
OryxOS is an open-source Distributed AI Agent OS
mantishack
开源
用AI智能体自动挖漏洞,提升渗透测试效率
Mantis Hack
xint
开源
本地命令行玩转 X 数据,搜索监控分析导出一步到位
Local-first X Intelligence CLI for search, monitoring, analysis, exports, OAuth acti···
