RedNote-MCP
installs/mo · npmstarsforks
How to install RedNote-MCP?
ifuryst/rednote-mcp
$git clone https://github.com/iFurySt/RedNote-MCP小红书内容访问的MCP服务
README.md
| 1 | # RedNote MCP |
| 2 | |
| 3 | [](docs/README.en.md) |
| 4 | [](README.md) |
| 5 | [](https://www.npmjs.com/package/rednote-mcp) |
| 6 | |
| 7 | 小红书内容访问的MCP服务 |
| 8 | |
| 9 | https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a |
| 10 | |
| 11 | ## 快速开始 |
| 12 | |
| 13 | 开始前确保安装了 [playwright](https://github.com/microsoft/playwright) 环境： |
| 14 | |
| 15 | ```bash |
| 16 | npx playwright install |
| 17 | ``` |
| 18 | |
| 19 | ### NPM 全局安装 |
| 20 | |
| 21 | ```bash |
| 22 | # 全局安装 |
| 23 | npm install -g rednote-mcp |
| 24 | |
| 25 | # 初始化登录，会自动记录cookie到 ~/.mcp/rednote/cookies.json |
| 26 | rednote-mcp init |
| 27 | ``` |
| 28 | |
| 29 | ### 从源码安装 |
| 30 | |
| 31 | ```bash |
| 32 | # 克隆项目 |
| 33 | git clone https://github.com/ifuryst/rednote-mcp.git |
| 34 | cd rednote-mcp |
| 35 | |
| 36 | # 安装依赖 |
| 37 | npm install |
| 38 | |
| 39 | # 全局安装（可选，方便命令行调用） |
| 40 | npm install -g . |
| 41 | |
| 42 | # 或者直接运行，如初始化登录 |
| 43 | npm run dev -- init |
| 44 | ``` |
| 45 | |
| 46 | ## 功能特性 |
| 47 | |
| 48 | - 认证管理（支持 Cookie 持久化） |
| 49 | - 关键词搜索笔记 |
| 50 | - 命令行初始化工具 |
| 51 | - 通过 URL 访问笔记内容 |
| 52 | - [ ] 通过 URL 访问评论内容 |
| 53 | |
| 54 | ## 使用说明 |
| 55 | |
| 56 | ### 1. 初始化登录 |
| 57 | |
| 58 | 首次使用需要先进行登录初始化： |
| 59 | |
| 60 | ```bash |
| 61 | rednote-mcp init |
| 62 | # 或者直接从源码run |
| 63 | npm run dev -- init |
| 64 | # 或者mcp-client里选择login |
| 65 | ``` |
| 66 | |
| 67 | 执行此命令后： |
| 68 | |
| 69 | 1. 会自动打开浏览器窗口 |
| 70 | 2. 跳转到小红书登录页面 |
| 71 | 3. 请手动完成登录操作 |
| 72 | 4. 登录成功后会自动保存 Cookie 到 `~/.mcp/rednote/cookies.json` 文件 |
| 73 | |
| 74 | ### 2. 在 Cursor 中配置 MCP Server |
| 75 | |
| 76 | 在 Cursor 的 settings.json 中添加以下配置： |
| 77 | |
| 78 | ```json |
| 79 | { |
| 80 | "mcpServers": { |
| 81 | "RedNote MCP": { |
| 82 | "command": "rednote-mcp", |
| 83 | "args": [ |
| 84 | "--stdio" |
| 85 | ] |
| 86 | } |
| 87 | } |
| 88 | } |
| 89 | ``` |
| 90 | |
| 91 | 或者使用 npx 方式： |
| 92 | |
| 93 | ```json |
| 94 | { |
| 95 | "mcpServers": { |
| 96 | "RedNote MCP": { |
| 97 | "command": "npx", |
| 98 | "args": [ |
| 99 | "rednote-mcp", |
| 100 | "--stdio" |
| 101 | ] |
| 102 | } |
| 103 | } |
| 104 | } |
| 105 | ``` |
| 106 | |
| 107 | 配置说明： |
| 108 | |
| 109 | - `command`: 可以是全局安装后的 `rednote-mcp` 命令，或使用 `npx` 直接运行 |
| 110 | - `args`: 必须包含 `--stdio` 参数以支持 Cursor 的通信方式 |
| 111 | |
| 112 | ## 开发指南 |
| 113 | |
| 114 | ### 环境要求 |
| 115 | |
| 116 | - Node.js >= 16 |
| 117 | - npm >= 7 |
| 118 | |
| 119 | ### 开发流程 |
| 120 | |
| 121 | ```bash |
| 122 | # 安装依赖 |
| 123 | npm install |
| 124 | |
| 125 | # 构建项目 |
| 126 | npm run build |
| 127 | |
| 128 | # 开发模式运行 |
| 129 | npm run dev |
| 130 | |
| 131 | # 运行测试 |
| 132 | npm test |
| 133 | ``` |
| 134 | |
| 135 | ### 使用 MCP Inspector 进行调试 |
| 136 | |
| 137 | MCP Inspector 是一个用于调试 MCP 服务器的工具，可以帮助开发者检查和验证 MCP 服务器的行为。使用以下命令启动： |
| 138 | |
| 139 | ```bash |
| 140 | npx @modelcontextprotocol/inspector npx rednote-mcp --stdio |
| 141 | ``` |
| 142 | |
| 143 | 这个命令会： |
| 144 | |
| 145 | 1. 启动 MCP Inspector 工具 |
| 146 | 2. 通过 Inspector 运行 rednote-mcp 服务 |
| 147 | 3. 提供一个交互式界面来检查请求和响应 |
| 148 | 4. 帮助调试和验证 MCP 协议的实现 |
| 149 | |
| 150 | ## 注意事项 |
| 151 | |
| 152 | 1. 首次使用必须执行 `init` 命令进行登录 |
| 153 | 2. Cookie 文件包含敏感信息，避免泄露 |
| 154 | 3. 建议定期更新 Cookie，避免失效 |
| 155 | 4. 确保已正确安装 Node.js 环境 |
| 156 | |
| 157 | ## 贡献指南 |
| 158 | |
| 159 | 1. Fork 本仓库 |
| 160 | 2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`) |
| 161 | 3. 提交你的改动 (`git commit -m 'Add some AmazingFeature'`) |
| 162 | 4. 推送到分支 (`git push origin feature/AmazingFeature`) |
| 163 | 5. 开启一个 Pull Request |
| 164 | |
| 165 | ## 许可证 |
| 166 | |
| 167 | MIT License - 详见 [LICENSE](LICENSE) 文件 |
People who liked this also viewed
6 picksType
- redis-vl-pythonRedis Vector Library (RedisVL) -- the AI-native Python client for Redis.MCP ServersJul 2026
- pipeworx gatewayLive data for AI agents. 250+ data sources, 900+ tools. Ask questions in plain English with ask_pipeworx — trade flows, SEC filings, drug safety, housing data, and more. No API keys needed.MCP Serversrecently
- dbt-mcpA MCP (Model Context Protocol) server for interacting with dbt.MCP ServersJul 2026
- mcp-server-chart🤖 A visualization mcp & skills contains 25+ visual charts using @antvis. Using for chart generation and data analysis.MCP ServersMay 2026
- mempalaceThe best-benchmarked open-source AI memory system. And it's free.MCP ServersJul 2026
- jupyter-mcp-server🪐 🔧 Model Context Protocol (MCP) Server for Jupyter.MCP ServersJul 2026
