Skip to main content
Glama
mcp-server-iqiyi

mcp-server-iqiyi

by ZHANGYA0

MCP Server for iQiYi

This project provides an MCP server implementation to access two iQiyi API endpoints:

  1. Get New Releases: Fetches the latest released videos.

  2. Get Trending Videos: Fetches the most popular videos.

The server is built using the FastMCP framework and exposes these functionalities as tools that can be accessed via the MCP protocol.

Features

  • Get New Releases: Returns a list of newly released videos with details such as title, description, image URL, and video URL.

  • Get Trending Videos: Returns a list of trending videos with similar details.

  • Customizable Configuration: Supports environment variables to configure user-specific parameters like IQIYI_UID, IQIYI_AUTH, and IQIYI_DEVICE.

  • Customizable Logging: Allows specifying a custom log directory and log file path.

Related MCP server: Bilibili MCP Server

Tools

get_new_releases

Fetches the latest released videos.

Inputs:

  • count (optional, integer): Number of videos to return (default: 14).

Returns: A formatted string containing details of the latest released videos.


Fetches the most popular videos.

Inputs:

  • count (optional, integer): Number of videos to return (default: 14).

Returns: A formatted string containing details of the trending videos.


Installation

  1. Create a Virtual Environment

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
  2. Install Dependencies Install the required Python packages using requirements.txt:

    pip install -r requirements.txt

Configuration Example

Below is an example configuration for integrating this MCP server into your environment:

{
  "mcpServers": {
    "mcp-server-iqiyi": {
      "command": "uv",
      "args": [
        "--directory",
        "D:\\myFile\\code\\mcp-server-iqiyi\\mcp-server-iqiyi",
        "run",
        "main.py"
      ],
      "autoApprove": [
        "get_new_releases",
        "get_trending_videos"
      ],
      "disabled": false,
      "timeout": 30,
      "env": {
        "IQIYI_UID": "<YOUR_UID>",
        "IQIYI_AUTH": "<YOUR_AUTH_TOKEN>",
        "IQIYI_DEVICE": "<YOUR_DEVICE_ID>",
        "IQIYI_LOG_DIR": "D:/custom/logs",  // Optional: Custom log directory
        "IQIYI_LOG_FILE": "D:/custom/logs/mcp-server-iqiyi.log"  // Optional: Custom log file path
      }
    }
  }
}

Environment Variables

  • IQIYI_UID: Your iQiyi user ID.

  • IQIYI_AUTH: Authentication token for accessing the iQiyi API.

  • IQIYI_DEVICE: Device identifier for the API request.

  • IQIYI_LOG_DIR (Optional): Directory where logs will be stored. Defaults to D:/temp/logs.

  • IQIYI_LOG_FILE (Optional): Full path to the log file. Defaults to D:/temp/logs/mcp-server-iqiyi.log.

Usage

  1. Clone the repository to your local machine.

  2. Configure the MCP server settings as shown in the example above.

  3. Start the MCP server using the configured command:

    uv --directory D:\myFile\code\mcp-server-iqiyi\mcp-server-iqiyi run main.py
  4. Use the following tools:

    • get_new_releases: Fetches the latest released videos.

    • get_trending_videos: Fetches the most popular videos.

Logging

Logs are stored in the directory specified by the IQIYI_LOG_DIR environment variable or the default directory D:/temp/logs. You can also specify a custom log file path using the IQIYI_LOG_FILE environment variable.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Available Tools

2 tools
get_new_releasesC

Get newly released videos.

Args:
    count: Number of videos to return (default 10)

Inputs: count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation4/5

    The tools target distinct video categories: new releases vs. trending. While there could be some overlap, the descriptions clearly differentiate them based on release date vs. play count.

    Naming Consistency5/5

    Both tools follow the consistent verb_noun pattern (get_new_releases, get_trending_videos), with similar structure and parameter naming.

    Tool Count2/5

    With only 2 tools, the server is extremely minimal for a video platform. Typical video services require many more operations (details, search, categories, user interactions), so this feels insufficient.

    Completeness1/5

    The tool surface covers only basic read operations for two video lists. Missing essential operations like video details, search, categories, or any write actions, making it severely incomplete.

    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.
      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.
      102 npm
      198
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      MCP server for TikTok that enables searching videos, users, hashtags, and fetching trending content, user profiles, and video details via official API or public scraping.
      8
      -