Skip to content

iFurySt/RedNote-MCP

Repository files navigation

RedNote MCP

English 简体中文 npm

小红书内容访问的MCP服务

demo.mp4

快速开始

开始前确保安装了 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
# 或者直接从源码run
npm run dev -- init
# 或者mcp-client里选择login

执行此命令后:

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

2. 在 Cursor 中配置 MCP Server

在 Cursor 的 settings.json 中添加以下配置:

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

或者使用 npx 方式:

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

配置说明:

  • command: 可以是全局安装后的 rednote-mcp 命令,或使用 npx 直接运行
  • args: 必须包含 --stdio 参数以支持 Cursor 的通信方式

开发指南

环境要求

  • Node.js >= 16
  • npm >= 7

开发流程

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式运行
npm run dev

# 运行测试
npm test

使用 MCP Inspector 进行调试

MCP Inspector 是一个用于调试 MCP 服务器的工具,可以帮助开发者检查和验证 MCP 服务器的行为。使用以下命令启动:

npx @modelcontextprotocol/inspector npx rednote-mcp --stdio

这个命令会:

  1. 启动 MCP Inspector 工具
  2. 通过 Inspector 运行 rednote-mcp 服务
  3. 提���一个交互式界面来检查请求和响应
  4. 帮助调试和验证 MCP 协议的实现

注意事项

  1. 首次使用必须执行 init 命令进行登录
  2. Cookie 文件包含敏感信息,避免泄露
  3. 建议定期更新 Cookie,避免失效
  4. 确保已正确安装 Node.js 环境

贡献指南

  1. Fork 本仓库
  2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交你的改动 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启一个 Pull Request

许可证

MIT License - 详见 LICENSE 文件

About

🚀MCP server for accessing RedNote(XiaoHongShu, xhs).

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •