yt-mcp-server

yt-mcp-server

YouTube データを扱うためのさまざまなユーティリティ関数を備えた MCP サーバーです。YouTube の URL、動画 ID、サムネイルを扱うためのツールを提供します。

📖 リソース

• Model Context Protocol

前提条件

• Python 3.12 以降
• パッケージマネージャーの UV

セットアップ

1. UV をインストールする

UV をまだインストールしていない場合は、次の方法でインストールできます。

brew install uv
# alternatively curl -LsSf https://astral.sh/uv/install.sh | sh

2. インストール方法

方法 1：GitHub からインストールする（推奨）

サーバーをインストールして実行する最も簡単な方法です。

uvx --from git+https://github.com/kdr/yt-mcp-server.git server

方法 2：ローカル開発環境のセットアップ

コードをローカルで変更する場合は、次の手順に従ってください。

git clone https://github.com/kdr/yt-mcp-server.git
cd yt-mcp-server
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
uv pip install -e .

3. MCP クライアントを設定する

次の設定を MCP クライアントの設定に追加してください。

{
    "mcpServers": {
        "yt-mcp-server": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/kdr/yt-mcp-server.git",
                "server"
            ]
        }
    }
}

ローカル開発（方法 2）の場合は、代わりに次の設定を使用してください。

{
    "mcpServers": {
        "yt-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yt-mcp-server/yt_mcp_server",
                "run",
                "main.py"
            ]
        }
    }
}

利用可能なツール

LLM では次のツールを利用できます。

• get_watch_url：指定した動画 ID の YouTube 視聴 URL を返します。任意で開始時間を指定できます

  • パラメーター：
    • video_id：YouTube 動画 ID
    • start_time：（任意）開始時間（秒）

• get_thumbnail_url：指定した YouTube 動画 ID のサムネイル URL を返します

  • パラメーター：
    • video_id：YouTube 動画 ID

• get_normalized_url：さまざまな形式の YouTube URL を標準の視聴 URL に正規化し、動画 ID を抽出します

  • パラメーター：
    • url：正規化する YouTube URL