JinDaGe - rednote-mcp MCP Details

article

README

🚀 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

执行此命令后：

自动打开浏览器窗口
跳转至小红书登录页面
请手动完成登录操作
成功登录后会自动保存 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 等]

rednote-mcp