RedNote-MCP

RedNote-MCP: A Comprehensive MCP Server for Accessing RedNote (小红书)

RedNote-MCP serves as an essential tool for efficiently accessing content from the popular platform RedNote (小红书). This MCP server enables seamless interaction with the platform, ensuring users can retrieve notes, comments, and other relevant information effortlessly.

Key Features

• Authentication Management: Supports cookie persistence for streamlined access.
• Keyword Note Search: Easily search for notes using relevant keywords.
• Command Line Initialization Tool: Simplifies the login and setup process with command line commands.
• Markdown Compatibility: Ideal for users who prefer working with Markdown-formatted notes.
• Planned Enhancements: Future implementations will include accessing notes and comments via direct URLs.

Getting Started

To begin using RedNote-MCP, an initialization process is required, which sets up the cookie file necessary for subsequent access. This ensures that user sessions are maintained securely.

Initial Login Setup

To initialize the login, run the command:

rednote-mcp init

Upon execution, this command will open a browser window directing you to the RedNote login page. After completing the login, the cookie file will be saved automatically for future use.

Configuring MCP Server in Cursor

To connect the RedNote MCP server with the Cursor application, simply add the following configuration to your settings.json:

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

Alternatively, use the npx method to execute the server:

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

Development Guidelines

RedNote-MCP is built for developers. The environment requirements include:

• Node.js version 16 or higher
• npm version 7 or higher

Using the following commands, developers can install dependencies, build, and run the project in a development mode:

# Install Dependencies
npm install

# Build Project
npm run build

# Run in Development Mode
npm run dev

# Execute Tests
npm test

Debugging with MCP Inspector

Developers can leverage the MCP Inspector tool, a dedicated debugging application for MCP servers, which helps validate and examine server behavior. Start the inspector with:

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

This command initiates the Inspector, allowing for an interactive exploration of requests and responses, aiding in debugging and protocol validation.

Important Notes

• The init command is mandatory for first-time users to set up necessary login credentials.
• The cookie file contains sensitive information; proper precautions should be taken to safeguard it.
• Frequently update the cookie to prevent session expiration.
• Ensure that Node.js and npm are properly installed for optimal functionality.

Contribution

Contributions to the RedNote-MCP project are encouraged. Steps include:

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

RedNote-MCP aims to enhance content accessibility on RedNote, making it a valuable resource for developers and users alike.