小红书内容访问的MCP服务
小红书内容访问的MCP服务 https://github.com/user-attachments # 项目概述 本项目旨在提供一个微服务架构，用于处理小红书平台上的用户附件（如图片、视频等）的存储与访问。通过采用多云提供商(MCP)策略，我们能够确保数据的高可用性和可靠性。 # 技术栈 - **后端**: Spring Boot, MyBatis - **数据库**: MySQL - **对象存储**: 阿里云OSS, AWS S3 - **消息队列**: RabbitMQ - **缓存**: Redis - **容器化**: Docker - **持续集成/持续部署(CI/CD)**: Jenkins - **版本控制**: Git (GitHub) # 快速开始 ## 环境准备 确保你的开发环境已经安装了以下软件： - JDK 1.8 或更高版本 - Maven 3.6.0 或更高版本 - Docker 和 Docker Compose - MySQL 5.7 或更高版本 - Redis 4.0 或更高版本 - RabbitMQ 3.8 或更高版本 ## 构建项目 bash mvn clean install ## 启动服务 使用Docker Compose来启动所有必要的服务。 bash docker-compose up -d ## 访问API文档 Swagger UI 可以用来查看和测试API接口。 - 地址: `http://localhost:8080/swagger-ui.html` # 配置说明 配置文件位于`src/main/resources/application.yml`中。根据实际部署环境调整相关参数，例如数据库连接信息、对象存储凭证等。 # 贡献指南 欢迎任何形式的贡献！请先阅读[贡献者指南](CONTRIBUTING.md)了解如何参与进来。 # 许可证 本项目采用MIT许可证发布，请参阅[LICENSE](LICENSE)获取更多信息。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"RedNote MCP": {
"args": [
"rednote-mcp",
"--stdio"
],
"command": "npx"
}
}
}服务介绍
RedNote MCP
小红书内容访问的MCP服务
https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a
快速开始
开始前确保安装了 playwright 环境：
npx playwright install
NPM 全局安装
# 全局安装
npm install -g rednote-mcp
# 初始化登录，会自动记录cookie到 ~/.mcp/rednote/cookies.json
rednote-mcp init
从源码安装
# 克隆项目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp
# 安装依赖
npm install
# 全局安装（可选，方便命令行调用）
npm install -g .
# 或者直接运行，如初始化登录
npm run dev -- init
功能特性
- 认证管理（支持 Cookie 持久化）
- 关键词搜索笔记
- 命令行初始化工具
- 通过 URL 访问笔记内容
- 通过 URL 访问评论内容
使用说明
1. 初始化登录
首次使用需要先进行登录初始化：
rednote-mcp init
# 或者直接从源码run
npm run dev -- init
# 或者mcp-client里选择login
执行此命令后：
- 会自动打开浏览器窗口
- 跳转到小红书登录页面
- 请手动完成登录操作
- 登录成功后会自动保存 Cookie 到
~/.mcp/rednote/cookies.json文件
2. 在 Cursor 中配置 MCP Server
在 Cursor 的 settings.json 中添加以下配置：
{
"mcpServers": {
"RedNote MCP": {
"command": "rednote-mcp",
"args": [
"--stdio"
]
}
}
}
或者使用 npx 方式：
{
"mcpServers": {
"RedNote MCP": {
"command": "npx",
"args": [
"rednote-mcp",
"--stdio"
]
}
}
}
配置说明：
command: 可以是全局安装后的rednote-mcp命令，或使用npx直接运行args: 必须包含--stdio参数以支持 Cursor 的通信方式
开发指南
环境要求
- Node.js >= 16
- npm >= 7
开发流程
# 安装依赖
npm install
# 构建项目
npm run build
# 开发模式运行
npm run dev
# 运行测试
npm test
使用 MCP Inspector 进行调试
MCP Inspector 是一个用于调试 MCP 服务器的工具，可以帮助开发者检查和验证 MCP 服务器的行为。使用以下命令启动：
npx @modelcontextprotocol/inspector npx rednote-mcp --stdio
这个命令会：
- 启动 MCP Inspector 工具
- 通过 Inspector 运行 rednote-mcp 服务
- 提供一个交互式界面来检查请求和响应
- 帮助调试和验证 MCP 协议的实现
注意事项
- 首次使用必须执行
init命令进行登录 - Cookie 文件包含敏感信息，避免泄露
- 建议定期更新 Cookie，避免失效
- 确保已正确安装 Node.js 环境
贡献指南
- Fork 本仓库
- 创建你的特性分支 (
git checkout -b feature/AmazingFeature) - 提交你的改动 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
许可证
MIT License - 详见 LICENSE 文件
