Douban MCP Server

Instructions

Implementation Reference

• src/index.ts:25-55 (registration)

  Registration of the 'search-book' tool with MCP server, including description, input schema, and inline handler function.

  server.tool(
    TOOL.SEARCH_BOOK,
    'search books from douban, either by ISBN or by query',
    {
      q: z.string().optional().describe('query string, e.g. "python"'),
      isbn: z.string().optional().describe('ISBN number, e.g. "9787501524044"')
    },
    async (args) => {
      if (!args.isbn && !args.q) {
        throw new McpError(ErrorCode.InvalidParams, "Either q or isbn must be provided")
      }
      const books = await searchBooks(args)
      const text = json2md({
        table: {
          headers: ['publish_date', 'title', 'author', 'rating' ,'id', 'isbn'],
          rows: books.map(_ => ({
            id: _.id || '',
            title: _.title || '',
            author: (_.author || []).join('、'),
            publish_date: _.pubdate,
            isbn: _.isbn13 || '',
            rating: `${_.rating?.average || 0} (${_.rating?.numRaters || 0}人)`
          }))
        }
      })
  
      return {
        content: [{ type: 'text', text }]
      }
    }
  );

• src/api.ts:9-20 (helper)

  Helper function searchBooks that dispatches to keyword or ISBN search on Douban API.

  export async function searchBooks(params: {
    q?: string
    isbn?: string
  }) {
    if (params.q) {
      return searchByKeyword(params.q)
    }
    if (params.isbn) {
      return searchByISBN(params.isbn)
    }
    return []
  }

• src/api.ts:22-36 (helper)

  Implementation of keyword-based book search using Douban v2 API.

  async function searchByKeyword (q: string) {
    const url = new URL('https://api.douban.com/v2/book/search')
    url.searchParams.set('q', q)
    url.searchParams.set('apikey', apiKey)
    const res: {
      count: number
      start: number
      total: number
      books: Douban.Book[]
    } = await (await fetch(url.toString(), {
      headers: FAKE_HEADERS
    })).json()
  
    return res?.books ? res.books.map(parseDoubanBook) : []
  }

• src/types.ts:1-9 (schema)

  TOOL enum defining the 'search-book' name as SEARCH_BOOK constant, used for registration.

  export enum TOOL {
    SEARCH_BOOK = 'search-book',
    LIST_BOOK_REVIEWS = 'list-book-reviews',
    SEARCH_MOVIE = 'search-movie',
    LIST_MOVIE_REVIEWS = 'list-movie-reviews',
    BROWSE = 'browse',
    LIST_GROUP_TOPICS = 'list-group-topics',
    GET_GROUP_TOPIC_DETAIL = 'get-group-topic-detail'
  }

• src/types.ts:12-54 (schema)

  TypeScript interface for Douban Book, used in search results.

  interface Book {
    rating: {
      max: number
      numRaters: number
      average: string
      min: number
    }
    subtitle: string
    author: string[]
    pubdate: string
    tags: {
      count: number
      name: string
      title: string
    }[]
    origin_title: string
    image: string
    binding: string
    translator: any[]
    catalog: string
    pages: string
    images: {
      small: string
      large: string
      medium: string
    }
    alt: string
    id: string
    publisher: string
    isbn10: string
    isbn13: string
    title: string
    url: string
    alt_title: string
    author_intro: string
    summary: string
    series: {
      id: string
      title: string
    }
    price: string
    ebook_url: string
  }