MCP-rednote-assistant

This MCP server, named rednote-agent, collects data from the Xiaohongshu Rednote platform. It relies on cookies extracted from a supported browser to authenticate sessions and fetch data. The workflow starts with generating an MCP configuration by running the provided Python-based cookies utility, which reads your exported cookies and outputs an MCP-ready config. Once the configuration is generated, you run the MCP server on Windows using the supplied mcp_windows.bat launcher. The server runs in long-running mode and communicates over stdio with the MCP framework. Use the rednote-agent to continuously gather data per the cookies you provided and managed by the MCP server platform.

Prerequisites:

• Windows 10 or later (per README) and Python 3.13 installed
• Access to export Xiaohongshu cookies via a browser extension (e.g., J2TEAM Cookies) or equivalent
• Network access to Xiaohongshu as needed for data collection

Steps:

1. Prepare a Python virtual environment and install dependencies

# optional: create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate  # on Windows use: venv\Scripts\activate

# install required Python packages
pip install -r requirements.txt

2. Export cookies to a file and run the cookies utility to generate MCP config

# ensure you have the path to your saved cookies (e.g., C:\path\to\cookies.json)
python cookies.py --input_path C:\path\to\xiaohongshu_cookies.json

3. Review the generated MCP configuration output. It will be used by the MCP server controller. The expected snippet resembles the one shown in the README, typically saved to the project root or a specified location.

4. Place the launcher script (mcp_windows.bat) in the installation path and ensure the path in the MCP config points to it. Then configure the MCP server as described in mcp_config and start the MCP framework to load the rednote-agent server.

Tips:

• If the MCP server fails to start after cookies changes, re-export cookies and re-run the cookies.py utility to regenerate the MCP config.
• Keep your cookies file secure; the utility uses it to authenticate requests to Xiaohongshu.
• This setup is designed for Windows. The launcher is a batch file (mcp_windows.bat) and uses a long-running stdio interface.
• If you need to update the agent version within MCP, toggle the rednote-agent server off and on in the MCP server management UI or configuration, then restart.
• Ensure the installation_path in your environment matches where you place mcp_windows.bat and related files.