MCP_RedNote_Downloader

<h1>🧩 MCP Server</h1> <p><b>Locally running</b> MCP Server provides the ability for the Agent to download Xiaohongshu images, videos, and LivePhotos via URL and to retrieve work information. Thanks to <a href="https://github.com/JoeanAmier">JoeanAmier</a> for maintaining the open-source project <a href="https://github.com/JoeanAmier/XHS-Downloader">XHS-Downloader</a>.</p> <h2>Installation Guide</h2> <p>1. &nbsp Clone the project code to your local machine: <code>git clone --recurse-submodules --depth=1 git@github.com:sn0w-Xue/MCP_RedNote_Downloader.git</code></p> <p>2. &nbsp Synchronize project environment dependencies: <code>cd tool && uv sync && uv add fastmcp</code></p> <p>3. &nbsp Configure the MCP Server:</p> <p>MacOS / Linux</p> <pre> { "mcpServers": { "RedNote downloader": { "timeout": 600, "type": "stdio", "command": "uv", "args": [ "run", "--project", "project_path/tool", "project_path/main.py" ] } } } </pre> <p>Windows</p> <pre> { "mcpServers": { "RedNote downloader": { "disabled": false, "timeout": 600, "type": "stdio", "command": "cmd", "args": [ "/c", "uv", "run", "--project", "project_path/tool", "project_path/main.py" ] } } } </pre> <h2>Usage Guide</h2> <p>Currently, there are 2 MCP Tools available:</p> <p>1. &nbsp <code>download_rednote_work</code> <p>&nbsp&nbsp&nbsp&nbspThis tool is used to download Xiaohongshu works (images, videos, LivePhotos). The Agent can automatically recognize the Xiaohongshu work links that this tool can download.</p> <p>&nbsp&nbsp&nbsp&nbspAn example request would be: <code>Help me download the content from this link: http://xhslink.com/m/XXX</code></p> <p>2. &nbsp <code>get_rednote_work_info</code> <p>&nbsp&nbsp&nbsp&nbspThis tool is used to retrieve information about Xiaohongshu works, including the number of favorites, comments, shares, likes, work tags, work ID, work link, work title, work description, work type, publication time, last update time, timestamp, author nickname, author ID, author link, download address, GIF address, etc.</p> <p>&nbsp&nbsp&nbsp&nbspAn example request would be: <code>Who published this work? How many likes does it have?</code></p>