Youtube MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows downloading closed captions from YouTube videos, which can be used for creating video summaries and analyzing video content

Youtube MCP サーバー

について

サーバーは、Youtube API と AI アシスタント間のブリッジであり、モデル コンテキスト プロトコルに基づいています。

MCPとは何ですか?

モデルコンテキストプロトコル(MCP)は、Claude DesktopのようなAIアプリが外部ツールやデータソースに接続できるようにするシステムです。これにより、AIアシスタントがローカルサービスやAPIを操作しながら、ユーザーによる操作を明確かつ安全に行えるようになります。

このサーバーは何をしますか?

  • [x] 指定されたビデオのクローズドキャプションをダウンロードする

実用的なユースケース

  • [x] ビデオの要約を作成する

前提条件

インストール

uv tool install git+https://github.com/sparfenyuk/mcp-youtube

[!NOTE] サーバーをすでにインストールしている場合は、 uv tool upgrade --reinstallコマンドを使用して更新できます。

[!NOTE] サーバーを削除する場合は、 uv tool uninstall mcp-youtubeコマンドを使用します。

構成

クロードデスクトップ構成

Claude Desktop を Youtube MCP サーバーを認識するように設定します。

  1. Claude Desktop 構成ファイルを開きます。
    • MacOSでは、設定ファイルは~/Library/Application Support/Claude/claude_desktop_config.jsonにあります。
    • Windowsでは、構成ファイルは%APPDATA%\Claude\claude_desktop_config.jsonにあります。

    注: claude_desktop_config.json は Claude Desktop アプリの設定内にもあります。

  2. サーバー構成を追加する
    { "mcpServers": { "mcp-youtube": { "command": "mcp-youtube", } } } }

発達

はじめる

  1. リポジトリをクローンする
  2. 依存関係をインストールする
    uv sync
  3. サーバーを実行する
    uv run mcp-youtube --help

ツールはsrc/mcp_youtube/tools.pyファイルに追加できます。

新しいツールを追加する方法:

  1. ToolArgsから継承する新しいクラスを作成する
    class NewTool(ToolArgs): """Description of the new tool.""" pass
    クラスの属性はツールの引数として使用されます。クラスのdocstringはツールの説明として使用されます。
  2. 新しいクラスにtool_runner関数を実装する
    @tool_runner.register async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]: pass
    この関数は、TextContent、ImageContent、またはEmbeddedResourceのシーケンスを返す必要があります。この関数は非同期で、新しいクラスの単一の引数を受け入れる必要があります。
  3. 完了です。クライアントを再起動すると、新しいツールが利用できるようになります。

検証は、Claude Desktop を通じて、またはツールを直接実行することによって実行できます。

インスペクターでサーバーをデバッグする

MCPインスペクターは、洗練されたUIを使用してサーバーのデバッグを支援するツールです。実行するには、次のコマンドを使用します。

npx @modelcontextprotocol/inspector uv run mcp-youtube

トラブルシューティング

メッセージ「MCP サーバー mcp-youtube に接続できませんでした」

Claude Desktop に「MCP サーバー mcp-youtube に接続できませんでした」というメッセージが表示される場合は、サーバーの構成が正しくないことを意味します。

次のことを試してください。

  • 設定ファイルでmcp-youtubeバイナリへのフルパスを使用します

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

YouTube API と AI アシスタントを橋渡しし、字幕をダウンロードして処理し、YouTube 動画の要約を作成することで動画分析を可能にします。

  1. About
    1. What is MCP?
      1. What does this server do?
        1. Practical use cases
          1. Prerequisites
            1. Installation
              1. Configuration
                1. Claude Desktop Configuration
              2. Development
                1. Getting started
                2. Debugging the server in the Inspector
              3. Troubleshooting
                1. Message 'Could not connect to MCP server mcp-youtube'
              ID: gzrh7914k6