RedNote MCP

RedNote MCP

🚀用于访问 RedNote（小红书，xhs）的 MCP 服务器。

iFurySt

开发者工具
访问服务器

README

RedNote MCP

English 简体中文 npm

小红书内容访问的MCP服务

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

快速开始

开始前确保安装了 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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件

# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的MCP服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
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 文件


# RedNote MCP

[![English](https://img.shields.io/badge/English-Click-yellow)](docs/README.en.md)
[![简体中文](https://img.shields.io/badge/简体中文-点击查看-orange)](README.md)
[![npm](https://img.shields.io/npm/v/rednote-mcp)](https://www.npmjs.com/package/rednote-mcp)

小红书内容访问的 MCP 服务

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

## 快速开始

开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境：

```bash
npx playwright install

NPM 全局安装

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript