Youtube Semantic Search

🚀 YouTube MCP サーバー

このサーバーは、YouTube動画の検索、字幕の取得、動画内容の意味検索を行うためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このサーバーを使用することで、公式APIを使用せずにYouTube動画を検索し、字幕を取得し、動画情報と字幕をベクトルデータベースに保存し、保存された字幕に対して意味検索を行うことができます。

✨ 主な機能

• 公式APIを使用せずにYouTube動画を直接検索することができます。
• 動画の字幕を取得することができます。
• 動画情報と字幕をベクトルデータベースに保存することができます。
• 保存された動画字幕に対して意味検索を行うことができます。

📦 インストール

前提条件

• 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

💻 使用例

基本的な使用法

from mcp_youtube import YouTubeMCPClient

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

🚀 サーバーの起動

1. 直接起動

ターミナルで以下のコマンドを実行してサーバーを起動します：

python server.py

2. Claude.app用に設定

このプロジェクトをClaude.appのプラグインディレクトリに追加し、プラットフォームの説明に従って設定します。

🔧 デバッグ

1. .envファイルに正しいGoogle APIキーが含まれていることを確認します。
2. すべての依存関係が正しくインストールされていることを確認します。
3. サーバーが実行中で、接続を待機していることを確認します。
4. サーバーの出力にエラーメッセージがあるかどうかを確認します。

🤝 貢献

貢献を歓迎します！プルリクエストをいつでも送信してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。

🍵 支援

もしこのプロジェクトが役に立ったと感じて、将来のプロジェクトを支援したい場合は、コーヒーを一杯買ってくれることを検討してください！あなたの支援は、革新的なAIソリューションの構築を続けるための励みになります。

あなたの貢献は、スマートで使いやすいアプリケーションの開発を続けるための大きな励みになります。