金大哥 - douban-mcp MCP 详情

article

README

🚀 豆瓣MCP服务器

此MCP服务器提供了搜索和交互豆瓣（中国社交网络服务平台）内容的功能，涵盖书籍、电影和小组讨论，能有效满足用户对豆瓣各类信息的查询需求。

🚀 快速开始

入门步骤

克隆仓库
安装依赖: npm install
构建服务器: npm run build
启动服务器: 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 搜索书籍
查看书籍评论
按标题搜索电影
查看电影评论
在默认浏览器中浏览书籍详情
列出带有筛选选项的小组主题
查看特定小组主题的详细信息

📦 安装指南

环境搭建

克隆仓库
安装依赖: npm install
构建服务器: npm run build
启动服务器: 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"

📚 详细文档

组件

工具

| 工具名称 | 功能 | 输入参数 | | ---- | ---- | ---- | | 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 |

🔧 技术细节

开发命令

构建: 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 下许可。

douban-mcp