article
README
🚀 红笔记 MCP 服务
红笔记 MCP 服务为小红书内容访问提供支持,借助该服务可通过关键词搜索笔记,还能使用其提供的 MCP 服务接口,并且能自动保存登录信息,同时兼容 Playwright 环境。



🚀 快速开始
使用前请确保安装了 Playwright 环境,可通过以下命令进行安装:
npx playwright install
📦 通过 Smithery 安装
要自动为 Claude Desktop 安装 rednote-mcp,请访问 Smithery 并运行以下命令:
npx -y @smithery/cli install @JonaFly/rednote-mcp --client claude
📦 通过 npm 全局安装
# 全局安装
npm install -g rednote-mcp
# 初始化登录,会自动将 cookie 保存到 ~/.mcp/rednote/cookies.json 文件中
rednote-mcp init
📦 从源码安装
# 克隆项目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp
# 安装依赖
npm install
# 全局安装(可选,为了方便命令行调用)
npm install -g .
# 或者直接运行初始化登录
npm run dev -- init
✨ 主要特性
- 🔍 支持通过关键词搜索笔记。
- 🚪 提供 MCP 服务接口。
- 💾 自动保存 cookie 到指定文件。
- 🛠️ 兼容 Playwright 环境。
💻 使用示例
初始化登录
安装完成后,运行以下命令初始化登录:
rednote-mcp init
这将启动浏览器窗口,指导您完成登录流程,并自动保存登录信息到 ~/.mcp/rednote/cookies.json 文件中。
配置 MCP 服务
要配置 MCP 服务,请按照以下步骤操作:
- 打开终端或命令提示符。
- 运行以下命令启动服务:
rednote-mcp serve
📚 详细文档
开发指南
环境要求
- Node.js(推荐使用最新稳定版本)
- npm(随 Node.js 自动安装)
开发流程
- 克隆项目仓库。
- 安装依赖:
npm install
- 运行开发服务器:
npm run dev
注意事项
⚠️ 重要提示
- 首次使用时必须运行
init命令完成初始化。- 请妥善保管 cookie 文件,避免泄露登录信息。
- 确保 Node.js 和 npm 环境已正确安装。
贡献指南
- 叉仓库。
- 创建功能分支(例如:
git checkout -b feature/AmazingFeature)。 - 提交更改(如
git commit -m 'Add some AmazingFeature')。 - 推送到分支(如
git push origin feature/AmazingFeature)。 - 提交 Pull Request。
📄 许可证
本项目采用 MIT License,具体内容请参见 LICENSE 文件。
扫码联系在线客服