Douyu MCP Py

🚀 鬥魚搜索器MCP服務器

這是一個輕量級的MCP服務器，支持通過鬥魚房間ID或關鍵詞搜索獲取鬥魚直播房間信息，能為用戶提供便捷的房間信息查詢服務。

✨ 主要特性

• 房間信息查詢：藉助 get_room(room_id) 工具，只需輸入鬥魚房間ID，就能獲取詳細的房間信息，涵蓋頭像、分區、主播、狀態、熱度等內容。
• 關鍵詞搜索房間：使用 search_rooms(keyword) 工具，輸入關鍵詞，即可搜索相關的鬥魚房間。
• Markdown表格輸出：所有信息均以美觀的Markdown表格形式返回，並且支持圖片展示。

📦 安裝指南

前置條件

• Python 3.10+
• pip

安裝步驟

1. 克隆本倉庫：

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

2. 安裝依賴：

   uv install
   

💻 使用示例

運行和測試

• 在Windows下直接運行：

  ./inspector.cmd
  

工具說明

工具：get_room(room_id)

根據鬥魚房間ID獲取房間詳細信息。

• 參數：room_id（整數，鬥魚房間ID）
• 返回：Markdown表格，包含頭像、房間ID、分區名、房間名、主播名、房間狀態、熱度、房間封面圖、房間鏈接。
• 示例輸出：

  | 名稱          | 信息             |
  |----------------|-------------------|
  | 頭像           | ![Avatar](https://example.com/avatar.jpg) |
  | 房間ID         | 12345   |
  | 分區名         | 英雄聯盟 |
  | 房間名         | 鬥魚最強 |
  | 主播名         | 張三 |
  | 房間狀態       | 直播中 |
  | 熱度           | 123456 |
  | 房間封面圖     | ![Room Thumb](https://example.com/thumb.jpg) |
  | 房間鏈接       | [Link](https://www.douyu.com/71415) |
  

工具：search_rooms(keyword)

通過關鍵詞搜索鬥魚房間，返回第一個相關房間信息。

• 參數：keyword（字符串，搜索關鍵詞）
• 返回：Markdown表格，包含分區名、是否直播、關鍵詞、主播暱稱、房間ID。
• 示例輸出：

  | 名稱          | 信息             |
  |----------------|-------------------|
  | 分區名         | 英雄聯盟 |
  | 是否直播       | 直播中 |
  | 關鍵詞         | 英雄聯盟 |
  | 主播暱稱       | 張三 |
  | 房間 ID       | 123456 |
  

📄 許可證

本項目採用MIT許可證，詳見 LICENSE。