Rednote MCP

🚀 RedNote MCP

RedNote MCP 是一个用于小红书内容访问的 MCP 服务，能够帮助用户便捷地访问小红书的笔记和相关内容，提供认证管理、搜索等功能。

🚀 快速开始

使用前请确保已安装 playwright 环境：

npx playwright install

📦 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

✨ 主要特性

• 认证管理（支持 Cookie 持久化）
• 关键词搜索笔记
• 命令行初始化工具
• 通过 URL 访问笔记内容
• [待完成] 通过 URL 访问评论内容

💻 使用示例

基础用法

1. 初始化登录

首次使用需先进行登录初始化：

rednote-mcp init
# 或者直接从源码运行
npm run dev -- init
# 或者在 mcp-client 中选择 login

执行此命令后：

1. 自动打开浏览器窗口
2. 跳转至小红书登录页面
3. 请手动完成登录操作
4. 成功登录后会自动保存 Cookie 到 ~/.mcp/rednote/cookies.json 文件

2. 在 Cursor 中配置 MCP 服务器

在 Cursor 的 settings.json 文件中添加以下配置：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

或者使用 npx 方式：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "npx",
      "args": [
        "rednote-mcp"
      ]
    }
  }
}

📚 详细文档

开发指南

环境要求

• Node.js 和 npm 已安装
• 安装 playwright：npx playwright install

开发流程

# 克隆项目并进入目录
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安装依赖
npm install

# 运行开发版本
npm run dev

调试工具

使用 playwright 提供的调试工具进行调试：

npx playwright

注意事项

⚠️ 重要提示

• 首次使用：请先运行初始化命令 rednote-mcp init
• Cookie 安全：请妥善保管 ~/.mcp/rednote/cookies.json 文件，防止泄露

贡献指南

• 代码仓库地址：https://github.com/ifuryst/rednote-mcp
• 欢迎 Fork 和 Pull Request
• 如有任何问题，请在 Issues 中提交

📄 许可证

[此处应放置具体的许可证内容，如 MIT 或 Apache 等]