ifuryst/rednote-mcp

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

1.1K stars 186 forks Quality 64 Trend 23MIT

Repository Install

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

Overview

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a - Authentication management (supports cookie persistence) - Keyword search notes - Command-line initialization tool - Access note content via URL - [ ] Access comment content via URL 1. The browser window will open automatically. 2. You will be redirected to the Xiaohongshu login page. 3. Please complete the login operation manually. 4. After successful login, the cookie will be automatically saved to the ~/.mcp/rednote/cookies.json file - command: Can be the globally installed rednote-mcp command or run directly using npx. - args: Must include the --stdio parameter to support communication in Cursor MCP Inspector is a tool for debugging MCP servers that helps developers check and verify the behavior of MCP servers. Start with the following command: 1. Launch the MCP Inspector tool 2. Run the rednote-mcp service through Inspector 3. Provide an interactive interface for checking requests and responses 4. Help debug and verify the implementation of the MCP protocol 1. First-time users must run the init command to log in. 2. Cookie files contain sensitive information to prevent leaks. 3. It is recommended to update cookies regularly to avoid invalidation. 4. Ensure the Node.js environment is installed correctly 1. Fork this repository 2. Create your feature branch (git checkout -b feature/AmazingFeature) 3. Submit your changes (git commit -m 'Add some AmazingFeature') 4. Push to branch (git push origin feature/AmazingFeature) 5. Start a Pull Request

Overview (machine translated)

MCP services for content access on Xiaohongshu

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

Get Started Quickly

Before starting, make sure Playwright is installed:

NPM Global Installation

Install from source code

Functional Features

Authentication management (supports cookie persistence)
Keyword search notes
Command-line initialization tool
Access note content via URL
[ ] Access comment content via URL

Instructions for use

First-time users need to perform login initialization:

After executing this command:

The browser window will open automatically
Redirect to the Xiaohongshu login page
Please complete the login operation manually
After successful login, the cookie will be automatically saved to the ~/.mcp/rednote/cookies.json file

2. Configure the MCP Server in Cursor

Add the following configuration to Cursor’s settings.json:

Or use the npx method:

Configuration Description:

command: Can be the rednote-mcp command after global installation, or run directly using npx.
args: The --stdio parameter must be included to support the communication method of Cursor

Development Guide

Environmental Requirements

Node.js >= 16
npm >= 7

Development Process

Debugging with MCP Inspector

MCP Inspector is a tool for debugging MCP servers that helps developers check and verify the behavior of MCP servers. Start with the following command:

This command will:

Launch the MCP Inspector tool
Run the rednote-mcp service through Inspector
Provide an interactive interface to check requests and responses
Assist in debugging and verifying the implementation of the MCP protocol

Notes

For first-time users, you must run the init command to log in
Cookie files contain sensitive information to prevent leaks
It is recommended to update cookies regularly to avoid invalidation
Ensure the Node.js environment is properly installed

Contribution Guide

Fork the warehouse
Create your feature branch (git checkout -b feature/AmazingFeature)
Submit your changes (git commit -m 'Add some AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Start a Pull Request

License

MIT License - See the LICENSE document for details

This page was translated automatically. Technical details may differ from the original.

Install

npx rednote-mcp --stdio

New to MCP? Start with the mcpskill.org guide →

Configuration

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