MCP Omega

VOID Omega MCP服务器

VOID的旗舰通用媒体内容提供商。

特性

内容发现和流媒体

• 第1级（速度）：Zilean（即时DMM缓存）
• 第2层（备份）：TorBox/真实去噪（去噪和缓存检查）

AI助手（矢量）

• 对话式人工智能：Gemini驱动的聊天界面
• 个性化推荐：Trakt手表历史集成
• 深度链接：用于即时内容访问的自动TMDB ID查找
• 上下文感知：了解用户偏好和查看模式

元数据丰富

• TMDB集成：准确查找电影和电视节目的元数据
• 系统集成：社交功能、观看历史和统计数据

可用工具

search

在torrent源中搜索电影和电视节目。

参数：

• query （string）：要搜索的标题
• type （字符串）： movie 或 show
• season （整数，可选）：电视节目的季号
• episode （整数，可选）：电视节目的剧集号

resolve

使用报告服务将torrent哈希转换为可流式传输的URL。

参数：

• info_hash （string）：Torrent信息哈希
• api_keys （对象）：Debrid服务API密钥(torbox, realdebrid)

vector_chat

与Vector AI助手聊天以获得个性化建议。

参数：

• query （string）：用户的问题或请求
• history （array）：上下文聊天历史记录
• api_key （字符串）：Gemini API键
• trakt_token （字符串，可选）：Trakt OAuth访问令牌
• tmdb_api_key （字符串，可选）：用于元数据查找的TMDB API密钥
• user_context （字符串，可选）：附加上下文

矢量AI功能：

• 基于Trakt历史的个性化内容推荐
• 生成深度链接： [Title](void://show/12345) 用于即时播放
• 用途 tmdb_search 用于精确TMDB ID的内部工具
• 访问Trakt统计数据、历史记录和继续观看列表

tmdb_search （内部）

Vector AI用于查找准确的TMDB ID。

参数：

• query （string）：要搜索的标题
• type （字符串）： movie 或 show

设置

1. 安装依赖项:

   pip install -r requirements.txt

1. 运行服务器:

   python main.py
   # OR using uvicorn directly
   python -m uvicorn main:app --reload --host 0.0.0.0 --port 8000

1. 在VOID中配置:

- 前往“设置”>“MCP附加组件”>“（+）添加” - 网址： http://10.0.2.2:8000/mcp/sse （模拟器） - 网址： http://:8000/mcp/sse （物理设备）

API密钥

必需（客户提供）

• Gemini API密钥：Vector AI聊天需要
• TMDB API密钥：Vector AI深度链接所需

可选（客户提供）

• Trapt OAuth令牌：支持个性化推荐
• TorBox/Real-Debrid API密钥：流分辨率所需

环境变量（回退）

创建 .env 用于覆盖本地测试默认值的文件：

GEMINI_API_KEY=your_gemini_key
TORBOX_API_KEY=your_torbox_key
REALDEBRID_API_KEY=your_realdebrid_key

注： 在生产过程中，为了安全起见，API密钥应该从VOID应用程序per-request传递。

建筑

服务

• ZileanService (zilean.py)：DMM缓存搜索
• TorBox服务 (torbox.py)：债务清偿决议
• 矢量服务 (vector.py)：AI聊天编排
• TractService (trakt.py)：用户观看历史和统计数据
• TMDB服务 (tmdb.py)：用于精确TMDB ID的元数据查找

矢量AI系统提示

Vector使用严格的系统提示来确保精确的深度链接：

1. 总是 用途 tmdb_search 用于任何内容推荐的工具
2. 将链接格式化为 [Title](void:///)
3. 永不 猜测TMDB ID以避免幻觉
4. 将每次响应的搜索限制在3-4次，以防止过载

工作流程示例：

• 用户：“推荐一个科幻节目”
• 矢量调用： tmdb_search(query="The Expanse", type="show")
• TMDB返回： {"tmdb_id": 63639, "title": "The Expanse", ...}
• Vector回应：“我推荐 无垠的太空..."