Wetv Mcp

🎬 WeTV MCP Server

首个面向中文长视频流媒体的 MCP 服务。搜索、发现和探索 WeTV 与 Tencent Video (腾讯视频) 上的剧集、综艺、动漫和电影。

中文文档

---

✨ 这是什么？

wetv-mcp 是一个 Model Context Protocol (MCP) 服务，让 AI 助手（Claude、ChatGPT、Cursor 等）能够搜索和推荐 WeTV 与 Tencent Video 上的内容。它们是最大的中文流媒体平台，拥有 3.5 亿+ 月活跃用户。

这有什么意义？

YouTube 和 Spotify 都已经有 MCP 服务了，但中文长视频内容还没有任何 MCP 服务。这个项目填补了这一空白。

当你问 AI 助手 “我该看什么中文剧？” 时，它现在可以给你提供真实可靠的答案，包括播放链接、评分、演员信息和剧集更新——全部来自 WeTV/Tencent Video。

---

🚀 快速开始

选项 1：克隆并运行（推荐）

git clone https://github.com/aimeeluwang/wetv-mcp.git
cd wetv-mcp
npm install
npm run build

然后添加到你的 MCP 配置中：

{
  "mcpServers": {
    "wetv": {
      "command": "node",
      "args": ["/path/to/wetv-mcp/dist/index.js"]
    }
  }
}

💡 将 /path/to/wetv-mcp 替换为你克隆仓库时使用的实际路径。

配置文件位置：

• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）
• Cursor：项目根目录中的 .cursor/mcp.json
• Windsurf：~/.codebuddy/mcp.json
• WorkBuddy：~/.workbuddy/mcp.json

选项 2：远程模式（HTTP 服务）

cd wetv-mcp

# Start HTTP server
npm run start:http
# Server runs at http://localhost:3000/mcp

然后通过 Streamable HTTP 连接：

{
  "mcpServers": {
    "wetv": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

---

🛠️ 可用工具

工具	说明	示例查询
search_content	搜索所有内容的全文	“在 Tencent Video 上搜索《庆余年》”
get_trending	当前热门内容排行榜	“WeTV 上现在最火的剧是什么？”
get_popular	按综合评分排列的热门内容	“最受欢迎的中文动漫有哪些？”
get_content_detail	详细信息（简介、演员、评分、剧集）	“介绍一下《逐玉》——它讲的是什么？”
get_episodes	剧集列表，包含播出日期和播放链接	“《庆余年》第 3 季有多少集？”
get_recommendations	AI 驱动的个性化推荐	“推荐一些适合约会之夜看的浪漫内容”

支持的内容类型

• 📺 剧集（电视剧）——中国剧集、C-drama、古装／现代／奇幻剧
• 🎭 综艺节目（综艺）——真人秀、才艺竞赛、脱口秀
• 🎌 动漫（动漫）——中国动画（国漫）
• 🎬 电影（电影）——中国电影
• 📹 纪录片（纪录片）

支持的地区

• 🇨🇳 中国大陆（CN）
• 🇹🇭 泰国（TH）——WeTV
• 🇮🇩 印度尼西亚（ID）——WeTV
• 🇻🇳 越南（VN）——WeTV
• 🇲🇾 马来西亚（MY）——WeTV
• 🇵🇭 菲律宾（PH）——WeTV
• 🌏 全球（GLOBAL）

---

💬 对话示例

“我该看什么中文剧？”

User: What's trending on WeTV right now?

AI (via get_trending): Here are the top 5 trending dramas:

1. 🥇 Joy of Life Season 3 (庆余年 第三季) ★8.6
   Political intrigue meets comedy. Zhang Ruoyun returns as Fan Xian.
   👉 Watch: https://v.qq.com/x/cover/mzc00200qyn3.html

2. 🥈 Chasing Jade (逐玉) ★8.3
   Dual female leads in an epic fantasy adventure across three realms.
   👉 Watch: https://v.qq.com/x/cover/mzc00200zy26.html

3. 🥉 Legend of the Hunter (猎人传说) ★8.4
   Republic-era mystery thriller set in a primeval forest.
   👉 Watch: https://v.qq.com/x/cover/mzc00200lrcs.html

“我现在想看点浪漫的”

User: Recommend something romantic and sweet for tonight

AI (via get_recommendations with mood="romantic"):
Based on your mood, here are my picks:

1. Our Beautiful Encounters (我们的美好际遇) ★7.8
   Sweet office romance with a genius programmer meets CEO architect.

2. The Legend of Shen Li (与凤行) ★8.1
   Immortal romance starring Zhao Liying & Lin Gengxin.

3. Only For Love (以爱为营) ★7.6
   Top 3 on WeTV Southeast Asia — a charming CEO x journalist love story.

---

🏗️ 开发

# Install dependencies
npm install

# Run in development mode (stdio)
npm run dev

# Run HTTP server in development mode
npm run dev:http

# Build for production
npm run build

# Start production (stdio)
npm start

# Start production (HTTP)
npm run start:http

环境变量

变量	默认值	说明
WETV_MCP_PORT	3000	HTTP 服务端口

---

📡 API 端点（HTTP 模式）

端点	方法	说明
/mcp	POST	MCP JSON-RPC 请求
/mcp	GET	用于服务器通知的 SSE 流
/mcp	DELETE	关闭会话
/health	GET	健康检查
/	GET	服务信息和使用说明

---

🗺️ 路线图

• 6 个核心工具（搜索、趋势、热门、详情、剧集、推荐）
• Stdio + Streamable HTTP 双传输方式
• 多区域支持（中国 + 东南亚）
• 双语内容（中文 + 英文）
• OAuth 用户身份验证（追剧列表、观看进度跟踪）
• 字幕/转录文本检索
• WeTV API 实时集成
• 演员/剧组深度资料
• 评论/弹幕 AI 摘要
• 内容分析（B2B）

---

📄 许可证

MIT © aimeeluwang

---

🌟 参与贡献

欢迎提交 PR！请参阅 CONTRIBUTING.md 了解指南。

欢迎为以下领域贡献：

• 更多内容数据
• 新工具（字幕搜索、评论分析等）
• WeTV API 集成
• 多语言字幕支持
• Bug 报告和功能请求

---

为全球华语剧集社区倾情打造 ❤️。首个将中国流媒体内容带给 AI 助手的 MCP。