Douyu MCP Py

🚀 DouYuSearcher MCP Server

A lightweight MCP server that supports searching for Douyu live room information by Douyu room ID or keywords.

🚀 Quick Start

This server provides tools to easily obtain Douyu live room information. You can get detailed room information by room ID or search for rooms by keywords.

✨ Features

• Room Information Query: Use the get_room(room_id) tool. Input a Douyu room ID to get detailed room information (including avatar, category, anchor, status, popularity, etc.).
• Keyword Search for Rooms: Use the search_rooms(keyword) tool. Input keywords to search for relevant Douyu rooms.
• Markdown Table Output: All information is returned in a beautiful Markdown table format, supporting image display.

📦 Installation

Prerequisites

• Python 3.10+
• pip

Installation Steps

1. Clone this repository:

   git clone https://github.com/LokerL/douyu-mcp-py.git
   cd douyu-mcp-py
   

2. Install dependencies:

   uv install
   

💻 Usage Examples

Basic Usage

Run and Test

• Directly run on Windows:

  ./inspector.cmd
  

Advanced Usage

Tool: get_room(room_id)

Get detailed room information based on the Douyu room ID.

• Parameter: room_id (integer, Douyu room ID)
• Return: A Markdown table containing avatar, room ID, category name, room name, anchor name, room status, popularity, room cover image, and room link.
• Example Output:

  | Name          | Information             |
  |----------------|-------------------------|
  | Avatar         | ![Avatar](https://example.com/avatar.jpg) |
  | Room ID        | 12345   |
  | Category Name  | League of Legends |
  | Room Name      | The Strongest on Douyu |
  | Anchor Name    | Zhang San |
  | Room Status    | Live |
  | Popularity     | 123456 |
  | Room Cover     | ![Room Thumb](https://example.com/thumb.jpg) |
  | Room Link      | [Link](https://www.douyu.com/71415) |
  

Tool: search_rooms(keyword)

Search for Douyu rooms by keyword and return information about the first relevant room.

• Parameter: keyword (string, search keyword)
• Return: A Markdown table containing category name, live status, keyword, anchor nickname, and room ID.
• Example Output:

  | Name          | Information             |
  |----------------|-------------------------|
  | Category Name  | League of Legends |
  | Live Status    | Live |
  | Keyword        | League of Legends |
  | Anchor Nickname| Zhang San |
  | Room ID        | 123456 |
  

📄 License

This project is under the MIT License. See LICENSE for details.