Skip to main content
Glama

🎬 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 (腾讯视频).

npm version License: MIT MCP

中文文档


✨ 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

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

Then add to your MCP configuration:

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

💡 Replace /path/to/wetv-mcp with 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.json in your project root

  • Windsurf: ~/.codebuddy/mcp.json

  • WorkBuddy: ~/.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/mcp

Then 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:http

Environment Variables

Variable

Default

Description

WETV_MCP_PORT

3000

HTTP server port


📡 API Endpoints (HTTP Mode)

Endpoint

Method

Description

/mcp

POST

MCP JSON-RPC requests

/mcp

GET

SSE stream for server notifications

/mcp

DELETE

Close session

/health

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 tools
get_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_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.

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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An 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 npm
      198
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server enabling AI assistants to search, analyze, and generate content for Xiaohongshu (RedNote), China's leading lifestyle social media platform.
      6
      9
      MIT