Youtube Semantic Search

🚀 YouTube MCP 服務器

YouTube MCP 服務器是一個強大的工具，它能直接搜索 YouTube 視頻、獲取視頻字幕，還能對視頻內容進行語義檢索。藉助模型上下文協議（MCP），為用戶提供高效的視頻搜索和內容分析體驗。

🚀 快速開始

先決條件

• Python 3.8+
• Google API 密鑰用於嵌入
• uv 包管理器

安裝

1. 克隆此倉庫
2. 創建並激活虛擬環境（使用 uv）：

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate

3. 使用 uv 安裝依賴項：

uv pip install -r requirements.txt

4. 創建一個 .env 文件並添加您的 Google API 密鑰：

GOOGLE_API_KEY=your_api_key_here

運行服務器

有兩種方法可以運行服務器：

1. 直接方法

在終端中運行以下命令啟動服務器：

python server.py

2. 配置為 Claude.app 使用

將項目添加到 Claude.app 的插件目錄中，並按照平臺說明進行配置。

✨ 主要特性

• 無需使用官方 API 即可直接搜索 YouTube 視頻。
• 能夠獲取視頻字幕。
• 可將視頻信息和字幕存儲在向量數據庫中。
• 支持對存儲的視頻字幕進行語義檢索。

📦 安裝指南

克隆倉庫

克隆此倉庫到本地。

創建並激活虛擬環境

使用 uv 創建並激活虛擬環境：

uv venv
# 在 Windows 上：
.venv\Scripts\activate
# 在 Unix/MacOS 上：
source .venv/bin/activate

安裝依賴項

使用 uv 安裝項目所需的依賴項：

uv pip install -r requirements.txt

配置 API 密鑰

創建一個 .env 文件並添加您的 Google API 密鑰：

GOOGLE_API_KEY=your_api_key_here

💻 使用示例

基礎用法

from mcp_youtube import YouTubeMCPClient

client = YouTubeMCPClient()
results = client.search("人工智能")
print(results)

📚 詳細文檔

可用工具

• 搜索視頻：通過關鍵詞或過濾條件搜索 YouTube 視頻。
• 獲取字幕：提取指定視頻的字幕內容。
• 存儲信息：將視頻信息和字幕存儲到向量數據庫中，便於後續檢索。
• 語義檢索：通過對存儲的字幕進行語義分析，實現高效的視頻檢索。

與 MCP 客戶端一起使用

使用 YouTubeMCPClient 類與 MCP 客戶端進行交互，如上述示例所示。

🔧 技術細節

調試

1. 確保 .env 文件中包含正確的 Google API 密鑰。
2. 檢查所有依賴項是否已正確安裝。
3. 驗證服務器是否正在運行並偵聽連接。
4. 查看服務器輸出中的任何錯誤信息。

📄 許可證

本項目在 MIT 許可證下發布，詳細內容請參閱 LICENSE 文件。

支持我們

如果您發現此項目對您有幫助，並希望支持我們的未來項目，請考慮給我們買一杯咖啡！您的支持將幫助我們繼續構建創新的人工智能解決方案。

您的貢獻將極大地激勵我們繼續創造智能且用戶友好的應用程序。

貢獻

歡迎貢獻！請隨時提交拉取請求。