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