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、分区名、房间名、主播名、房间状态、热度、房间封面图、房间链接。
• 示例输出：
  | 名称 | 信息 | |----------------|-------------------| | 头像 |  | | 房间ID | 12345 | | 分区名 | 英雄联盟 | | 房间名 | 斗鱼最强 | | 主播名 | 张三 | | 房间状态 | 直播中 | | 热度 | 123456 | | 房间封面图 |  | | 房间链接 | [Link](https://www.douyu.com/71415) |

工具：search_rooms(keyword)

通过关键词搜索斗鱼房间，返回第一个相关房间信息。

• 参数：keyword（字符串，搜索关键词）
• 返回：Markdown 表格，包含分区名、是否直播、关键词、主播昵称、房间ID。
• 示例输出：
  | 名称 | 信息 | |----------------|-------------------| | 分区名 | 英雄联盟 | | 是否直播 | 直播中 | | 关键词 | 英雄联盟 | | 主播昵称 | 张三 | | 房间 ID | 123456 |

许可证

MIT License. 详见 LICENSE。