wetv-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wetv-mcp what's trending on WeTV right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎬 WeTV MCP Server
The first MCP server for Chinese long-form video streaming. Search, discover, and explore dramas, variety shows, anime, and movies on WeTV and Tencent Video (腾讯视频).
✨ What is this?
wetv-mcp is a Model Context Protocol (MCP) server that lets AI assistants (Claude, ChatGPT, Cursor, etc.) search and recommend content from WeTV and Tencent Video — the largest Chinese-language streaming platform with 350M+ monthly active users.
Why does this matter?
YouTube and Spotify already have MCP servers. But there's zero MCP coverage for Chinese long-form video content. This fills that gap.
When you ask your AI assistant "What Chinese drama should I watch?", it can now give you real answers with play links, ratings, cast info, and episode updates — all from WeTV/Tencent Video.
Related MCP server: Bilibili MCP Server
🚀 Quick Start
Option 1: Clone & Run (Recommended)
git clone https://github.com/aimeeluwang/wetv-mcp.git
cd wetv-mcp
npm install
npm run buildThen add to your MCP configuration:
{
"mcpServers": {
"wetv": {
"command": "node",
"args": ["/path/to/wetv-mcp/dist/index.js"]
}
}
}💡 Replace
/path/to/wetv-mcpwith the actual path where you cloned the repo.
Configuration file locations:
Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows)Cursor:
.cursor/mcp.jsonin your project rootWindsurf:
~/.codebuddy/mcp.jsonWorkBuddy:
~/.workbuddy/mcp.json
Option 2: Remote Mode (HTTP Server)
cd wetv-mcp
# Start HTTP server
npm run start:http
# Server runs at http://localhost:3000/mcpThen connect via Streamable HTTP:
{
"mcpServers": {
"wetv": {
"url": "http://localhost:3000/mcp"
}
}
}🛠️ Available Tools
Tool | Description | Example Query |
search_content | Full-text search across all content | "Search for Joy of Life on Tencent Video" |
get_trending | Current trending/hot content rankings | "What's the hottest drama on WeTV right now?" |
get_popular | Most popular content by combined score | "What are the most popular Chinese anime?" |
get_content_detail | Detailed info (synopsis, cast, rating, episodes) | "Tell me about Chasing Jade — what's it about?" |
get_episodes | Episode list with air dates and play links | "How many episodes does Joy of Life S3 have?" |
get_recommendations | AI-powered personalized recommendations | "Recommend something romantic for date night" |
Content Types Supported
📺 Dramas (电视剧) — Chinese dramas, C-dramas, period/modern/fantasy
🎭 Variety Shows (综艺) — Reality shows, talent competitions, talk shows
🎌 Anime (动漫) — Chinese animation (donghua)
🎬 Movies (电影) — Chinese films
📹 Documentaries (纪录片)
Regions Supported
🇨🇳 China Mainland (CN)
🇹🇭 Thailand (TH) — WeTV
🇮🇩 Indonesia (ID) — WeTV
🇻🇳 Vietnam (VN) — WeTV
🇲🇾 Malaysia (MY) — WeTV
🇵🇭 Philippines (PH) — WeTV
🌏 Global (GLOBAL)
💬 Example Conversations
"What Chinese drama should I watch?"
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"I'm in a romantic mood"
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.🏗️ Development
# 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:httpEnvironment Variables
Variable | Default | Description |
|
| HTTP server port |
📡 API Endpoints (HTTP Mode)
Endpoint | Method | Description |
| POST | MCP JSON-RPC requests |
| GET | SSE stream for server notifications |
| DELETE | Close session |
| GET | Health check |
| GET | Server info & usage instructions |
🗺️ Roadmap
6 core tools (search, trending, popular, detail, episodes, recommendations)
Stdio + Streamable HTTP dual transport
Multi-region support (China + Southeast Asia)
Bilingual content (Chinese + English)
OAuth user authentication (watchlist, progress tracking)
Subtitle/transcript retrieval
Live WeTV API integration
Cast/crew deep profiles
Comment/danmaku AI summaries
Content analytics (B2B)
📄 License
MIT © aimeeluwang
🌟 Contributing
PRs welcome! See CONTRIBUTING.md for guidelines.
Key areas where contributions are appreciated:
Additional content data
New tools (subtitle search, comment analysis, etc.)
WeTV API integration
Multi-language subtitle support
Bug reports and feature requests
Built with ❤️ for the global C-drama community. The first MCP to bring Chinese streaming content to AI assistants.
Available Tools
6 toolsget_content_detailA
Get detailed information about a specific drama, movie, variety show, or anime on WeTV/Tencent Video (腾讯视频). Returns full details including synopsis, cast, rating, episode count, update schedule, play links, and available regions/subtitles.
Inputs: id (required).
get_episodesA
Get the episode list for a specific drama, anime, or variety show on WeTV/Tencent Video. Returns episode numbers, names, durations, air dates, and play links with subtitle information.
Inputs: content_id (required), page, per_page.
get_popularA
Get the most popular content on WeTV and Tencent Video (腾讯视频) ranked by combined popularity score (views × rating). Different from trending - popular shows the all-time best-performing content.
Inputs: type, limit, region.
get_recommendationsA
Get personalized content recommendations from WeTV/Tencent Video (腾讯视频) based on genre preferences, mood, or viewing context. This is the AI drama advisor - perfect for "what should I watch tonight?", "recommend something for a date", or "I'm in the mood for something exciting". Supports both Chinese and English genre/mood keywords.
Inputs: mood, type, genre, limit, +1 more.
get_trendingA
Get the current trending/hot content on WeTV and Tencent Video (腾讯视频). Returns the hottest dramas, variety shows, anime, and movies ranked by real-time heat index. Perfect for answering "what's hot right now" or "what should I watch".
Inputs: type, limit, region.
search_contentA
Search for dramas, variety shows, anime, movies, and documentaries on WeTV and Tencent Video (腾讯视频). Supports searching by title, actor, director, genre, or keywords in both Chinese and English.
Inputs: query (required), page, type, region, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct purpose: search_content handles targeted queries, get_trending and get_popular are separated by time horizon, get_content_detail provides specifics, get_episodes lists episodes, and get_recommendations offers personalized suggestions. The overlap between trending/popular/recommendations is clearly explained in descriptions.
All tools use a consistent verb-first pattern ('search' or 'get'), and most follow verb_noun structure. However, get_trending and get_popular omit the noun, using an adjective instead, which is a minor deviation from the otherwise uniform pattern.
Six tools is a well-scoped size for a video content discovery server. Each tool serves a necessary function—search, browse, detail, episodes, and recommendations—without redundancy or bloat.
The tool set covers the complete user journey: discovering content (search, trending, popular, recommendations), understanding it (detail), and accessing episodes. There are no obvious gaps for the stated purpose of exploring WeTV/Tencent Video content.
Maintenance
Related MCP Connectors
MCP server for real-time Chinese internet hot-search and trending boards across major platforms.
MCP server aggregating hot-search boards from 8 Chinese platforms (Weibo, Zhihu, Bilibili, Douyin).
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
MCP server for Hailuo (MiniMax) AI video generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables users to search for movie and TV show resources across multiple sources and validate video link playability. It supports both STDIO and SSE transport modes for seamless integration with AI applications.46 npm5MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables users to search Bilibili videos, access trending rankings, and retrieve detailed information about videos, content creators, and anime schedules. It allows AI applications to interact directly with Bilibili content via simple API interfaces.110 npm198MIT
- AlicenseAqualityDmaintenanceMCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.69MIT
- FlicenseBqualityDmaintenanceMCP server for accessing iQiyi API to fetch new releases and trending videos.21-