Rednote MCP

🚀 RedNote MCP

小红书のコンテンツにアクセスするためのMCPサービスです。

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

🚀 クイックスタート

開始する前に、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サーバーの設定

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: Cursorの通信方式をサポートするために、--stdio パラメータを含める必要があります。

📚 ドキュメント

開発環境の要件

• 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 ファイルを参照してください。