RedNote MCP

Quick Start

Ensure you have the playwright environment installed:

npx playwright install

NPM Global Installation

npm install -g rednote-mcp\n\n# Initialize login, cookies will be saved to ~/.mcp/rednote/cookies.json
ednote-mcp init

From Source Installation

 git clone https://github.com/ifuryst/rednote-mcp.git
 cd rednote-mcp\n\n# Install dependencies
 npm install\n\n# Global installation (optional)
 npm install -g .\n\n# Or run directly, e.g., initialize login
 npm run dev -- init

Features

• Authentication management (supports cookie persistence)
• Keyword search for notes
• Command line initialization tool
• Access note content via URL

Usage Instructions# 1. Initialize Login

First-time users need to perform login initialization:

rednote-mcp init\n\n# Or run directly from source
npm run dev -- init\n\n# Or select login in mcp-client

After executing this command:

1. A browser window will automatically open.
2. Redirect to the Xiaohongshu login page.
3. Complete the login operation manually.
4. Upon successful login, cookies will be saved to ~/.mcp/rednote/cookies.json.

2. Configure MCP Server in Cursor

Add the following configuration in Cursor's settings.json:

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

Or use npx:

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

Development Guide## Environment Requirements

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

Development Process

npm install\n\n# Build the project
npm run build\n\n# Run in development mode
npm run dev\n\n# Run tests
npm test

Use MCP Inspector for Debugging

MCP Inspector is a tool for debugging MCP servers, helping developers check and validate MCP server behavior. Start it with:

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

Notes

1. First-time users must execute the init command for login.
2. The cookie file contains sensitive information; avoid leaks.
3. Regularly update cookies to prevent expiration.
4. Ensure Node.js environment is correctly installed.

Contribution Guide

1. Fork this repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

MIT License - see LICENSE file.