VidWords YouTube MCP Server

AIエージェントがYouTube動画を読み取り、回答を得た正確な秒数を引用できる、ホスト型のModel Context Protocolサーバーです。

言語モデルは動画を見ることができません。このエンドポイントを指定すると、トランスクリプトの検索、動画のフレーム（スライド、チャート、デモ、画面上のテキスト）の読み取り、そして表示前に検証された引用付きの質問回答という9つのツールを利用できます。

統合コードは不要。スクレイピングも不要。プロキシプールも不要。

POST https://vidwords.com/mcp
Authorization: Basic <your-api-token>

リモート専用のホスト型サービスで、インストールやセルフホストは不要です。このリポジトリは、そのエンドポイントの公開マニフェスト、設定リファレンス、およびイシュートラッカーです。

クイックスタート

無料トークンを取得するには、vidwords.com/register でアカウントを作成し、メールを確認して、プロフィールからトークンをコピーします。無料プランには毎月のクレジットと10 Watch分が含まれているので、支払い前にセットアップして利用できます。

Claude Code

claude mcp add --transport http vidwords https://vidwords.com/mcp \
  --header "Authorization: Basic YOUR_API_TOKEN"

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "vidwords": {
      "type": "http",
      "url": "https://vidwords.com/mcp",
      "headers": { "Authorization": "Basic YOUR_API_TOKEN" }
    }
  }
}

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "vidwords": {
      "url": "https://vidwords.com/mcp",
      "headers": { "Authorization": "Basic YOUR_API_TOKEN" }
    }
  }
}

Codex CLI — ~/.codex/config.toml

[mcp_servers.vidwords]
url = "https://vidwords.com/mcp"
env_http_headers = { "Authorization" = "VIDWORDS_MCP_AUTH" }

export VIDWORDS_MCP_AUTH="Basic YOUR_API_TOKEN"

bearer_token_env_var は使用しないでください。一見正しそうなフィールドですが、Authorization: Bearer <value> を送信するのに対し、このサーバーは Basic 認証を使用します。

claude.ai と ChatGPT — OAuth、貼り付け不要

https://vidwords.com/mcp をカスタムコネクタとして追加します。ホストが自動登録し、VidWords にサインインするよう誘導し、何を要求しているかを正確に示す同意画面を表示します。登録だけでは何も許可されません。サインインしたユーザーが 承認 をクリックした時点で初めてアクセスが開始され、稼働中の接続はAPIページから即座に取り消すことができます。

カスタムヘッダー非対応のクライアントと Docker

このリポジトリには、stdin/stdout で MCP を話し、ツール呼び出しをホスト型エンドポイントに転送する小さな stdio プロキシ（src/index.js）も同梱されています。クライアントがカスタム HTTP ヘッダーを送信できない場合や、サーバーをコンテナで実行したい場合に使用します：

{
  "mcpServers": {
    "vidwords": {
      "command": "npx",
      "args": ["-y", "github:haljishi/vidwords-mcp"],
      "env": { "VIDWORDS_API_TOKEN": "YOUR_API_TOKEN" }
    }
  }
}

このリポジトリから直接実行してください。プロキシは npm に公開されていないため、単純な npx @vidwords/mcp では解決されません。

docker build -t vidwords-mcp .
docker run --rm -i -e VIDWORDS_API_TOKEN=YOUR_API_TOKEN vidwords-mcp

ツールスキーマはプロキシ内にインラインで宣言されているため、initialize と tools/list は認証情報なしで応答し、ツールが実際に呼び出されるまでアップストリームには接続されません。VIDWORDS_API_TOKEN がない場合の呼び出しは、ハンドシェイクを失敗させるのではなく、読みやすいエラーを返します。非本番インスタンスを指す場合は、VIDWORDS_MCP_URL でエンドポイントを上書きできます。

汎用の mcp-remote ブリッジも使用できます：

{
  "mcpServers": {
    "vidwords": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vidwords.com/mcp",
               "--header", "Authorization:Basic YOUR_API_TOKEN"]
    }
  }
}

既製の設定ファイルは examples/ にあります。

Related MCP server: YouTube Transcript MCP Server

9つのツール

get_transcript より search_transcript を優先

どちらも動画あたり1クレジットなので、料金面での選択理由はありません。理由はコンテキストです。「この2時間のインタビューで価格について何と言っていた？」と尋ねた場合、get_transcript は約20,000語を返しますが、そのうち価格に関するのはおそらく300語程度です。その300語は、関係のない19,700語と注意を競い合うことになり、回答は悪くなり、遅くなり、生成コストも高くなります。

search_transcript は一致した部分のみを返し、それぞれにディープリンクが付きます。本当に全文が必要な場合（エクスポート、差分、コーパスなど）は get_transcript を使用してください。

キャプションだけでなく画像も読み取る

analyze_video は、音声では決して話されないスライド、チャート、コードサンプル、画面上のテキストを調べます。ask_video はその保存された分析に基づいて回答し、すべての引用は表示前に検証されます：視覚的な主張は実際に記録されたフレームと一致する必要があり、音声の主張は実際のトランスクリプトセグメントに該当する必要があります。検証に失敗したものは破棄され、何も残らない場合は、自信のある推測を生成するのではなく、証拠が不十分であると回答します。

これは時には煩わしいものです。拒否は流暢な回答よりもデモとしては劣ります。しかし、エージェントは人間の読者が持つ懐疑心なしに言われたことを繰り返すため、これはこの機能をエージェントの前に置いても安全な唯一のバージョンです。

認証、コスト、制限

• Bearer ではなく Basic。 トークンはそのまま送信されます。user:pass のペアを base64 エンコードする必要はありません。

• 最初にメールを確認してください。 確認リンクをクリックするまで、すべての呼び出しは 403 と {"error":"email_unverified"} を返します。これは新規アカウントで最も一般的な初回呼び出しの失敗です。

• クレジットは1つのプールで、REST API とウェブサイトと共有されます。1クレジットはトランスクリプト1本分です。フレーム分析は代わりに Watch 分を消費し、開始前に拒否された実行はコストがかかりません。

• レート制限：30リクエスト / 10秒 — サーバーはステートレスで、クライアントは毎回の呼び出し前に initialize を再実行するため、REST API の5より意図的に緩く設定されています。analyze_video には、REST ルートと共有される1分あたり10回の開始という独自の上限があります。

• RapidAPI トークンはここでは拒否されます。 その ID は呼び出しごとに課金され、背後にアカウントがありません。どちらもツール呼び出しセッションでは維持されません。VidWords API トークンを使用してください。

• 設計上ステートレス。 再開可能な SSE ストリームも、削除するセッションもありません。すべてのツールは一発で応答します。GET と DELETE は HTML 404 ではなく JSON-RPC エラーを返します。

• キャプションが存在する必要があります。 キャプショントラックがない動画の場合、サインインしたアカウントは代わりに音声から文字起こしできます。長さに応じて料金が設定され、消費前に見積もりが表示されます。

詳細な料金：pricing。

ドキュメント

• YouTube MCP サーバー — 概要

• Claude Code でのセットアップ

• Claude Desktop でのセットアップ

• Cursor でのセットアップ

• REST API ドキュメント

サポート

MCP サーフェスに関するあらゆる問題（動作がおかしいツール、設定を文書化していないクライアント、より明確にできるスキーマなど）については、ここでイシューを開いてください。アカウントと請求に関する質問は サポート へ。

ライセンス

このリポジトリの内容（ドキュメントと設定例）は MIT ライセンスです。ホスト型サービス自体はプロプライエタリであり、VidWords 利用規約 に準拠します。

独立した製品です。YouTube や Google とは提携していません。