DouYuSearcher MCP Server

DouYuSearcher MCP Server

一个轻量级的 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. 详见 LICENSE。