RedNote MCP

访问小红书内容的MCP服务

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

快速开始

在启动playwright环境之前，请确保已安装它

npx playwright install

通过Smithery安装

要通过Smithery自动安装rednote-mcp给Claude Desktop：

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

功能

• 身份验证管理（支持cookie持久化）
• 关键词搜索笔记
• 命令行初始化工具
• 通过URL访问笔记内容
• 通过URL访问评论内容

使用说明

1. 初始化登录

首次使用需要初始化登录：

rednote-mcp init
# 或者直接从源码run
npm run dev -- init
# 或者mcp-client里选择login

执行此命令后：

1. 将自动打开一个浏览器窗口
2. 跳转到小红书的登录页面
3. 请手动完成登录操作
4. 登录成功后，cookies将自动保存到~/.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",
        "--stdio"
      ]
    }
  }
}

配置说明：

• command: 可以是全局安装的rednote-m_命令，也可以使用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. 建议定期更新cookies以避免过期
4. 确保Node.js环境已正确安装

贡献指南

1. 分叉本仓库
2. 创建你的功能分支（git checkout -b feature/AmazingFeature）
3. 提交你的更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开Pull Request

许可证

MIT许可证 - 查看详细信息LICENSE文档