Douban MCP

🚀 豆瓣MCPサーバー

English | 中文

このMCPサーバーは、豆瓣（中国のソーシャルネットワーキングサービスプラットフォーム）のコンテンツ（書籍、映画、グループディスカッションなど）を検索し、相互作用する機能を提供します。

✨ 主な機能

• 書籍名のキーワードまたはISBNで書籍を検索
• 書籍のレビューを閲覧
• タイトルで映画を検索
• 映画のレビューを閲覧
• デフォルトのブラウザで書籍の詳細を閲覧
• フィルタオプション付きでグループのトピックをリスト表示
• 特定のグループトピックの詳細情報を閲覧

📦 インストール

ツール

• search-book

  • 豆瓣から書籍情報を検索
  • 入力:
    • isbn (文字列, オプション): 取得する書籍のISBN
    • q (文字列, オプション): 書籍タイトルの検索キーワード

• list-book-reviews

  • 豆瓣から書籍のレビューを取得
  • 入力:
    • id (文字列): 豆瓣の書籍ID

• search-movie

  • 豆瓣から映画情報を検索
  • 入力:
    • q (文字列): 映画タイトルの検索キーワード

• list-movie-reviews

  • 豆瓣から映画のレビューを取得
  • 入力:
    • id (文字列): 豆瓣の映画ID

• browse

  • デフォルトのブラウザで書籍の詳細ページを開く
  • 入力:
    • id (文字列): 豆瓣の書籍ID

• list-group-topics

  • 豆瓣グループのトピックをリスト表示
  • 入力:
    • id (文字列, オプション): 豆瓣グループID（デフォルトは '732764'）
    • tags (文字列[], オプション): タグでトピックをフィルタリング
    • from_date (文字列, オプション): 日付でトピックをフィルタリング（形式: "YYYY-MM-DD"）

• get-group-topic-detail

  • 特定のトピックの詳細情報を取得
  • 入力:
    • id (文字列): 豆瓣のトピックID

🚀 クイックスタート

1. リポジトリをクローンする
2. 依存関係をインストール: npm install
3. サーバーをビルド: npm run build
4. サーバーを起動: npm start

デスクトップアプリとの統合使用

このサーバーをデスクトップアプリケーションと統合するには、アプリケーションのサーバー設定に以下を追加します。

{
  "mcpServers": {
    "douban-mcp": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ],
      "env": {
        "COOKIE": "bid=;ck=;dbcl2=;frodotk_db=;" // ウェブサイトからCookie値を取得
      }
    }
  }
}

🔧 開発

• ビルド: npm run build
• 監視モード: npm run dev
• 起動: npm start
• テスト: npm test

📚 ドキュメント

依存関係

• @modelcontextprotocol/sdk: MCP SDK
• dayjs: 日付ライブラリ
• json2md: JSONからMarkdownへの変換ツール
• turndown: HTMLからMarkdownへの変換ツール
• zod: TypeScriptの先行アーキテクチャ検証ツール

リソース

• 豆瓣 API ドキュメント

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。