Douban MCP

🚀 Douban MCP Server

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

🚀 Quick Start

Steps to Start the Server

1. Clone the repository.
2. Install dependencies: npm install
3. Build the server: npm run build
4. Start the server: npm start

Integration with Desktop Applications

To integrate this server with a desktop application, add the following to the application'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 the Cookie value from the website
      }
    }
  }
}

✨ Features

• Search for books by title keywords or ISBN.
• View book reviews.
• Search for movies by title.
• View movie reviews.
• Browse book details in the default browser.
• List group topics with filtering options.
• View detailed information about specific group topics.

📦 Installation

Development Commands

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

📚 Documentation

Components - Tools

🔧 Technical Details

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.