douyu-mcp-py

🚀 斗鱼搜索器MCP服务器

一个轻量级的 MCP 服务器，支持通过斗鱼房间ID或关键词搜索获取斗鱼直播房间信息，方便快捷地查询直播相关内容。

🚀 快速开始

斗鱼搜索器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。