Jephthah-git/youtube-mcp-server

YouTube MCP Server: Real-Time YouTube Data API for AI Assistants

Table of Contents

• Overview
• Features
• Installation
• Usage
• API Reference
• Contributing
• License
• Contact

Overview

The YouTube MCP Server is a robust Model Context Protocol (MCP) server designed to provide real-time access to the YouTube Data API. This server empowers AI assistants by offering 14 functions, including intelligent content evaluation and technology freshness scoring. These features enable effective knowledge base curation, making it easier for AI systems to deliver accurate and relevant information.

For the latest releases, please visit our Releases page.

Features

• Real-Time Data Access: Fetch YouTube data in real-time for immediate use.
• 14 Functions: Includes a wide range of functionalities tailored for AI applications.
• Content Evaluation: Analyze video content for quality and relevance.
• Technology Freshness Scoring: Score technology-related content to ensure your knowledge base remains current.
• Easy Integration: Designed to work seamlessly with AI agents and assistants.
• Python-Based: Built using Python, making it easy to extend and customize.
• Open Source: Available for anyone to use and modify.

Installation

To set up the YouTube MCP Server, follow these steps:

1. Clone the Repository:

   git clone https://github.com/Jephthah-git/youtube-mcp-server.git
   cd youtube-mcp-server
   

2. Install Dependencies: Make sure you have Python 3.8 or higher installed. Use pip to install the required packages.

   pip install -r requirements.txt
   

3. Run the Server: Start the server with the following command:

   python server.py
   

For the latest releases, please visit our Releases page.

Usage

Once the server is running, you can interact with it using HTTP requests. Below are some examples of how to use the various functions.

Example Requests

1. Get Video Details:

   curl -X GET "http://localhost:5000/video?video_id=YOUR_VIDEO_ID"
   

2. Evaluate Content:

   curl -X POST "http://localhost:5000/evaluate" -d '{"video_id": "YOUR_VIDEO_ID"}'
   

3. Freshness Score:

   curl -X GET "http://localhost:5000/freshness?video_id=YOUR_VIDEO_ID"
   

Response Format

The server responds with JSON data, making it easy to integrate into your applications. Here’s an example response for a video details request:

{
  "video_id": "YOUR_VIDEO_ID",
  "title": "Sample Video Title",
  "description": "This is a sample video description.",
  "views": 123456,
  "likes": 7890,
  "freshness_score": 0.85
}

API Reference

The YouTube MCP Server provides several endpoints. Below is a brief overview of the available API functions.

Endpoints

• GET /video: Retrieve details for a specific video.

  • Parameters: video_id

• POST /evaluate: Evaluate the content of a video.

  • Body: {"video_id": "YOUR_VIDEO_ID"}

• GET /freshness: Get the freshness score of a video.

  • Parameters: video_id

For more detailed documentation, refer to the API documentation included in the repository.

Contributing

We welcome contributions from the community. To contribute:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Submit a pull request.

Please ensure that your code adheres to the existing style and includes appropriate tests.

License

This project is licensed under the MIT License. See the file for details.

Contact

For questions or feedback, please reach out to the repository maintainer:

• Name: Jephthah
• Email: jephthah@example.com

Feel free to open issues for bugs or feature requests. We appreciate your contributions and feedback!