Douban MCP

🚀 豆瓣MCP服務器

此MCP服務器提供了搜索和交互豆瓣（中國社交網絡服務平臺）內容的功能，涵蓋書籍、電影和小組討論，能有效滿足用戶對豆瓣各類信息的查詢需求。

🚀 快速開始

入門步驟

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 值
      }
    }
  }
}

✨ 主要特性

• 按書名關鍵詞或 ISBN 搜索書籍
• 查看書籍評論
• 按標題搜索電影
• 查看電影評論
• 在默認瀏覽器中瀏覽書籍詳情
• 列出帶有篩選選項的小組主題
• 查看特定小組主題的詳細信息

📦 安裝指南

環境搭建

1. 克隆倉庫
2. 安裝依賴: npm install
3. 構建服務器: npm run build
4. 啟動服務器: npm start

💻 使用示例

基礎用法

以下是使用各個工具的基本示例：

搜索書籍

# 按關鍵詞搜索書籍
search-book --q "百年孤獨"

# 按ISBN搜索書籍
search-book --isbn "9787020049108"

查看書籍評論

list-book-reviews --id "123456"

搜索電影

search-movie --q "泰坦尼克號"

查看電影評論

list-movie-reviews --id "234567"

瀏覽書籍詳情

browse --id "123456"

列出小組主題

# 列出默認小組主題
list-group-topics

# 按標籤篩選主題
list-group-topics --tags "文學"

# 按日期篩選主題
list-group-topics --from_date "2024-01-01"

獲取小組主題詳情

get-group-topic-detail --id "345678"

📚 詳細文檔

組件

工具

🔧 技術細節

開發命令

• 構建: 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 下許可。