Douban MCP Server: API Orchestration & Seamless Integration

Douban MCP Server: Streamline API orchestration with robust performance, seamless integration, and developer-friendly tools—because even machines need a little豆瓣 magic.

Visit Repository

✨ Developer Tools

4.5(22 reviews)

33 saves

15 comments

Users create an average of 43 projects per month with this tool

About Douban MCP Server

What is Douban MCP Server: API Orchestration & Seamless Integration?

This server acts as a bridge between your applications and Douban's vast library of books, movies, and community discussions. By orchestrating Douban's APIs into a unified interface, it simplifies accessing content like reviews, search results, and group topics—all while keeping integration smooth for developers. Think of it as your one-stop tool to tap into Douban’s ecosystem without wrestling with raw API endpoints.

How to use Douban MCP Server: API Orchestration & Seamless Integration?

Getting started is straightforward: clone the repo, install dependencies, and fire up the server. To integrate with a desktop app, just plug in the provided config snippet—don’t forget to set your Douban cookie in the env variable! The server handles the heavy lifting, so your app can focus on displaying content like movie reviews or book details. Oh, and if you’re tweaking code, dev mode with hot reloading is a lifesaver.

Douban MCP Server Features

Key Features of Douban MCP Server: API Orchestration & Seamless Integration?

Book & Movie Mastery: Search by ISBN, title keywords, or dive deep into reviews using IDs. Want the physical book page? Just browse straight to Douban’s site.
Group Topic Control: Filter discussions by tags, dates, or group IDs. Dig into specific topics effortlessly with dedicated endpoints.
Plug-and-Play Integration: Designed for MCP compatibility, it slots into existing workflows with minimal setup. No more API auth headaches—just pass that cookie!

Use cases of Douban MCP Server: API Orchestration & Seamless Integration?

Douban MCP Server FAQ

FAQ from Douban MCP Server: API Orchestration & Seamless Integration?

Do I need a Douban account? Yes, the cookie is tied to your account’s permissions. Grab it from your browser’s storage.
What if the API changes? Keep an eye on Douban’s docs and the server’s dependency updates—we use their SDK to stay in sync.
Works on Windows/macOS/Linux? Node.js powers this, so anywhere Node runs is fair game.

Content

Douban MCP Server

English | 中文

This MCP server provides functionality to search and interact with Douban (a Chinese social networking service) content including books, movies, and group discussions.

Features

Search books by title keywords or ISBN
View book reviews
Search movies by title
View movie reviews
Browse book details in default browser
List group topics with filtering options
View group topic details

Components

Tools

search-book
- Search book info from Douban
- Input:
  - isbn (string, optional): ISBN of the book to fetch
  - q (string, optional): Search keyword of the book title
list-book-reviews
- Get book reviews from Douban
- Input:
  - id (string): Douban book ID
search-movie
- Search movie info from Douban
- Input:
  - q (string): Search keyword of the movie title
list-movie-reviews
- Get movie reviews from Douban
- Input:
  - id (string): Douban movie ID
browse
- Open book detail page in default browser
- Input:
  - id (string): Douban book ID
list-group-topics
- List topics from Douban groups
- Input:
  - id (string, optional): Douban group ID (defaults to '732764')
  - tags (string[], optional): Filter topics by tags
  - from_date (string, optional): Filter topics by date (format: "YYYY-MM-DD")
get-group-topic-detail
- Get details of a specific topic
- Input:
  - id (string): Douban topic ID

Getting started

Clone the repository
Install dependencies: npm install
Build the server: npm run build
Start the server: npm start

Usage with Desktop App

To integrate this server with a desktop app, add the following to your app's server configuration:

{
  "mcpServers": {
    "douban-mcp": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ],
      "env": {
        "COOKIE": "bid=;ck=;dbcl2=;frodotk_db=;" // get cookie value from website
      }
    }
  }
}

Development

Build: npm run build
Watch mode: npm run dev
Start: npm start
Test: npm test

Dependencies

@modelcontextprotocol/sdk: MCP SDK
dayjs: Date library
json2md: JSON to Markdown converter
turndown: HTML to Markdown converter
zod: TypeScript-first schema validation

Resources

Douban API Documentation

License

This project is licensed under the MIT License.

Related MCP Servers & Clients

MCP Categories

Developer Tools