关键词

豆瓣图书搜索电影搜索小组话题内容浏览

项目简介

豆瓣 MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 LLM 客户端提供豆瓣网的内容访问能力。该服务器通过注册工具 (Tools) 的方式，允许 LLM 客户端调用豆瓣读书、电影和小组相关 API，获取图书、电影信息以及豆瓣小组话题等内容，从而扩展 LLM 在文化娱乐信息领域的知识和功能。

主要功能点

  • 图书搜索: 支持通过关键词或 ISBN 搜索豆瓣图书信息。
  • 电影搜索: 支持通过关键词搜索豆瓣电影信息。
  • 浏览图书详情: 支持打开默认浏览器浏览指定豆瓣图书的详情页面。
  • 豆瓣小组话题: 支持获取豆瓣小组话题列表和话题详情，可以按标签和发布日期过滤。

安装步骤

  1. 克隆仓库

    git clone https://github.com/L-Chris/douban-mcp.git
cd douban-mcp

  2. 安装依赖

    npm install

  3. 构建项目

    npm run build

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如桌面应用程序），您需要配置服务器启动信息。以下是一个示例配置，您需要根据实际情况修改文件路径和豆瓣 Cookie。

{
  "mcpServers": {
    "douban-mcp": {
      "command": "node",  // 启动服务器的命令，这里使用 Node.js
      "args": [          // 命令参数，指向编译后的服务器入口文件
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" //  请替换为 dist/index.js 文件的绝对路径
      ],
      "env": {           // 环境变量
        "COOKIE": "bid=xxxxxxxx;ck=xxxxxxxx;dbcl2=xxxxxxxx;frodotk_db=xxxxxxxx;" // 从豆瓣网页获取的 Cookie 值，用于访问豆瓣 Frodo API，请替换为你的 Cookie
      }
    }
  }
}

请注意：

  • '{ABSOLUTE PATH TO FILE HERE}/dist/index.js' 必须替换 为您本地 'douban-mcp/dist/index.js' 文件的绝对路径。您可以通过在终端中 'cd douban-mcp' 然后运行 'pwd' 命令获取当前目录，再手动拼接上 'dist/index.js'。
  • 'COOKIE' 环境变量的值需要您登录豆瓣网站后手动获取。获取方法通常是在浏览器开发者工具中查看请求头或 Application/Cookies 选项卡。 'COOKIE' 的目的是为了访问豆瓣 Frodo API，某些豆瓣 API 可能需要登录态才能访问。

基本使用方法

  1. 启动服务器：在项目根目录下运行 'npm start' 命令，即可通过 stdio 启动 MCP 服务器。

  2. 在 MCP 客户端中配置并连接到该服务器后，您可以使用客户端提供的界面或指令，调用服务器注册的工具 (Tools)，例如 'search-book' (搜索图书), 'search-movie' (搜索电影), 'list-group-topics' (列出小组话题) 等，并根据工具的参数描述提供相应的输入参数，即可获取豆瓣相关信息。

例如，在支持 MCP 协议的 LLM 应用中，您可以指示 LLM 调用 'douban-mcp' 服务器的 'search-book' 工具，并提供关键词 "python" 来搜索 Python 相关的图书。服务器会将搜索结果以文本形式返回给 LLM 应用。

信息

分类

网页与API

访问项目