内容
# stremio-mcp
Stremio 统一 MCP 服务器。两个工具集在一个服务器中：
- **插件工具**：通过 Stremio 公共插件 HTTP API 进行搜索、元数据、目录和流列表。
- **Android TV 工具**：通过 adb 在运行 Stremio 的 Android TV 上播放内容和控制播放。
## 安装
### uvx（推荐）
```bash
uvx stremio-mcp
```
### pip
```bash
pip install stremio-mcp
stremio-mcp
```
### Homebrew
```bash
brew install yoanwai/tap/stremio-mcp
```
## MCP 客户端配置
```json
{
"mcpServers": {
"stremio": {
"command": "uvx",
"args": ["stremio-mcp"],
"env": {
"ANDROID_TV_HOST": "192.168.1.100",
"ANDROID_TV_PORT": "5555",
"STREMIO_AUTH_KEY": ""
}
}
}
}
```
使用 `.env` 文件代替内联环境变量：
```json
{
"mcpServers": {
"stremio": {
"command": "uvx",
"args": ["--env-file", "/path/to/.env", "stremio-mcp"]
}
}
}
```
## 环境变量
| 变量 | 默认值 | 是否必需 | 用途 |
|---|---|---|---|
| `ANDROID_TV_HOST` | （无） | TV 工具必需 | Android TV 的 IP 或主机名 |
| `ANDROID_TV_PORT` | `5555` | 否 | TV 上的 adb TCP 端口 |
| `ADB_PATH` | `adb` | 否 | adb 二进制文件的路径 |
| `STREMIO_AUTH_KEY` | （无） | 库工具必需 | Stremio 账户授权密钥（或使用 `stremio_login`） |
将 `.env.example` 复制到 `.env` 并填写您的值。
## 工具
### 插件工具
| 工具 | 描述 |
|---|---|
| `stremio_search` | 跨插件目录搜索电影和系列 |
| `stremio_get_meta` | 获取标题的完整元数据（季节、剧集、演员） |
| `stremio_browse_catalog` | 浏览插件目录（热门、趋势、类型） |
| `stremio_get_addon_manifest` | 检查插件的清单和功能 |
| `stremio_get_streams` | 列出标题或剧集的可用流 |
### 账户和库工具
| 工具 | 描述 |
|---|---|
| `stremio_login` | 使用电子邮件和密码登录以获取授权密钥 |
| `stremio_get_library` | 列出账户的已保存库标题 |
| `stremio_add_to_library` | 将电影或系列添加到库中 |
| `stremio_remove_from_library` | 从库中删除标题 |
### Android TV 工具
| 工具 | 描述 |
|---|---|
| `play` | 在 TV 的 Stremio 应用中打开并播放标题 |
| `tv_control` | 远程控制操作：播放/暂停/快进/倒退、导航、音量、电源 |
| `playback_status` | 报告当前正在播放的内容及其位置 |
## adb 配对
TV 工具需要访问 Android TV 的 adb：
1. 在 TV 上：设置 > 设备首选项 > 关于 > 点击 **构建** 7 次以启用开发者选项。
2. 在开发者选项中，启用 **USB 调试**（和 **网络调试**，如有）。
3. 从您的机器上：`adb connect <TV_IP>:5555` 并在 TV 屏幕上接受授权提示。
连接在大多数设备上重启后仍然保持；如果 TV 停止响应，请重新运行 `adb connect`。
## 许可证
MIT，见 [LICENSE](LICENSE)。
