AI导哈

小红书只读信息检索服务器

一个专注于小红书只读信息检索的独立MCP服务器，提供搜索笔记、获取评论、用户查询等功能。

  • by MapleCity1314
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MapleCity1314/xiaohongshu-mcp

使用说明

@presto1314w/小红树mcp

一个独立的小红书MCP服务器，专注于只读信息检索。

它提供了一个稳定的MCP表面，用于搜索小红书、阅读笔记、获取评论、检查用户和检查本地运行时健康状况。在幕后，它更喜欢Rust原生桥，并在需要时退回到供应商提供的传统Python CLI。

范围

当前MCP范围有意为只读：

  • 身份验证状态和运行时诊断
  • 搜索和主题发现
  • 注意细节和评论
  • 用户查找和用户帖子
  • 订阅源、热门项目、收藏夹、未读计数、通知

当前存储库的非目标：

  • 张贴笔记
  • 喜欢或不喜欢
  • 评论突变
  • 关注或取消关注
  • 删除操作

包裹

MCP端点：

npm:@presto1314w/xiaohongshu-mcp

主要入口点：

  • bin/xiaohongshu-mcp.mjs：MCP服务器
  • scripts/self-check.mjs：本地CLI诊断
  • native/：铁锈桥
  • legacy/：提供Python回退

MCP工具

当前导出的读取和诊断工具：

  • xiaohongshu_auth_status
  • xiaohongshu_runtime_self_check
  • xiaohongshu_profile_me
  • xiaohongshu_search
  • xiaohongshu_note_detail
  • xiaohongshu_comments
  • xiaohongshu_user_lookup
  • xiaohongshu_user_posts
  • xiaohongshu_feed
  • xiaohongshu_hot
  • xiaohongshu_topics
  • xiaohongshu_search_user
  • xiaohongshu_favorites
  • xiaohongshu_my_notes
  • xiaohongshu_unread
  • xiaohongshu_notifications

推荐阅读流程：

  1. 跑 xiaohongshu_runtime_self_check 当本地设置不确定时。
  2. 跑 xiaohongshu_auth_status 当请求可能取决于认证状态时。
  3. 使用 xiaohongshu_search, xiaohongshu_topics，或 xiaohongshu_search_user 为了发现。
  4. 使用 xiaohongshu_note_detail 和 xiaohongshu_comments 用于笔记级检索。
  5. 使用 xiaohongshu_user_lookup 和 xiaohongshu_user_posts 从笔记扩展到作者。

更多详细信息请参见 只读工作流.md.

运行时分辨率

网桥按以下顺序解析：

  1. XIAOHONGSHU_MCP_CLI_BIN
  2. dist/native/<platform>-<arch>/xiaohongshu-cli
  3. native/target/{release,debug}/xiaohongshu-cli
  4. XIAOHONGSHU_MCP_BIN
  5. uv run --project <legacy-root> xhs
  6. python3 -m xhs_cli.cli

兼容性别名：

  • Z0_XIAOHONGSHU_BIN
  • Z0_XIAOHONGSHU_CLI_BIN
  • Z0_XIAOHONGSHU_SOURCE_ROOT
  • Z0_XIAOHONGSHU_PYTHON_BIN

主要环境变量：

  • XIAOHONGSHU_MCP_BIN
  • XIAOHONGSHU_MCP_CLI_BIN
  • XIAOHONGSHU_MCP_SOURCE_ROOT
  • XIAOHONGSHU_MCP_PYTHON_BIN
  • XIAOHONGSHU_MCP_RELEASE_TARGETS

本地命令

pnpm install
pnpm self-check
pnpm demo:search -- travel
pnpm demo:note -- <id-or-url>
pnpm build
pnpm test
pnpm release:pack
XIAOHONGSHU_MCP_RELEASE_TARGETS=darwin-arm64,linux-x64 pnpm release:matrix

自检

pnpm self-check
pnpm self-check --json
pnpm self-check --no-auth-probe
pnpm self-check --probe-search travel

self-check 打印结构化的本地诊断，包括：

  • 电桥分辨率
  • 原生二进制发现
  • 打包工件可见性
  • 可选的身份验证探测 status --json
  • 可选搜索探测通过 search --json

演示命令

pnpm demo:search -- travel
pnpm demo:note -- https://www.xiaohongshu.com/explore/<id>

这些命令是存储库中最小的实际读取路径演示。它们遵循与MCP服务器相同的网桥解析规则，并打印结构化的JSON结果。

相关 MCP