Youtube MCP Server

🚀 YouTube MCP 服務器

這是一個使用 Flask 構建的服務器，它通過與 YouTube 數據 API 對接，能夠搜索歌曲並獲取對應的視頻鏈接，為用戶提供便捷的音樂搜索服務。

🚀 快速開始

本服務器使用 Flask 搭建，藉助 YouTube 數據 API 實現歌曲搜索和視頻鏈接獲取功能。以下是快速搭建並使用該服務器的步驟：

✨ 主要特性

• 利用 YouTube 數據 API 搜索歌曲。
• 可獲取視頻標題和鏈接。
• 免費使用，無需 Premium 訂閱。

📦 安裝指南

先決條件

1. Python 3.x：可從 python.org 進行安裝。
2. YouTube 數據 API 密鑰：可從 Google Cloud Console 獲取。

安裝步驟

1. 克隆倉庫

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

2. 創建並激活虛擬環境

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安裝依賴項

安裝所需的 Python 包。

4. 設置環境變量

在項目文件夾中創建一個 .env 文件，並將 YouTube API 密鑰添加到 .env 文件中：

YOUTUBE_API_KEY=your_api_key_here

5. 運行服務器

啟動 Flask 服務器：

python app.py

服務器將在 http://localhost:5000/ 上運行。

💻 使用示例

基礎用法

搜索歌曲時，向 /search 端點發送 POST 請求，請求體包含以下 JSON：

{
    "song_name": "Shape of You"
}

示例響應

如果找到歌曲，服務器將返回：

{
    "status": "success",
    "message": "找到視頻：Shape of You - Ed Sheeran",
    "video_title": "Shape of You - Ed Sheeran",
    "video_url": "https://www.youtube.com/watch?v=JGwWNGJdvx8"
}

如果沒有結果，服務器將返回：

{
    "status": "error",
    "message": "找不到 'Shape of You' 的視頻"
}

📚 詳細文檔

API 端點

• GET /：主頁，返回 "YouTube MCP 服務器正在運行！"。
• POST /search：搜索歌曲並獲取視頻詳細信息。

貢獻

歡迎貢獻！按照以下步驟進行：

1. 叉建華倉庫。
2. 創建新分支（git checkout -b feature/your-feature）。
3. 提交更改（git commit -m '添加某個功能'）。
4. 推送到分支（git push origin feature/your-feature）。
5. 打開拉取請求。

聯繫

如有問題或反饋，請隨時聯繫：

• 你的姓名：rakeshjayanna19@gmail.com
• GitHub：rakeshjayanna

如何使用本 README

1. 將上述內容複製到項目文件夾中的 README.md 文件。
2. 替換克隆 URL 中的 your-username 為你的 GitHub 用戶名。
3. 替換 .env 文件中的 your_api_key_here 為你實際的 YouTube 數據 API 密鑰。
4. 根據需要自定義 聯繫 部分。

最後說明

• README 文件是人們訪問你的 GitHub 倉庫時看到的第一件事。確保它清晰、簡潔且易於理解。
• 如果你需要進一步定製或有其他問題，請隨時告訴我！ 😊