Rednote MCP

🚀 RedNote MCP

小紅書內容訪問的MCP服務，提供認證管理、關鍵詞搜索等功能，助力便捷訪問小紅書內容。

🚀 快速開始

開始前，請確保已安裝 playwright 環境，可使用以下命令進行安裝：

npx playwright install

通過 Smithery 安裝

若要通過 Smithery 為 Claude Desktop 自動安裝 rednote-mcp，可使用以下命令：

npx -y @smithery/cli install @JonaFly/rednote-mcp --client claude

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
# 或者直接從源碼運行
npm run dev -- init
# 或者在 mcp-client 裡選擇 login

執行此命令後，會按以下步驟操作：

1. 自動打開瀏覽器窗口
2. 跳轉到小紅書登錄頁面
3. 請手動完成登錄操作
4. 登錄成功後，會自動保存 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

這個命令會：

1. 啟動 MCP Inspector 工具
2. 通過 Inspector 運行 rednote-mcp 服務
3. 提供一個交互式界面來檢查請求和響應
4. 幫助調試和驗證 MCP 協議的實現

🔧 注意事項

⚠️ 重要提示

1. 首次使用必須執行 init 命令進行登錄
2. Cookie 文件包含敏感信息，避免洩露
3. 建議定期更新 Cookie，避免失效
4. 確保已正確安裝 Node.js 環境

🤝 貢獻指南

1. Fork 本倉庫
2. 創建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的改動 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 開啟一個 Pull Request

📄 許可證

本項目採用 MIT 許可證，詳見 LICENSE 文件。