VidWords YouTube MCP Server

Размещённый на хостинге сервер Model Context Protocol, который позволяет ИИ-агенту читать видео с YouTube — и указывать точную секунду, из которой взят ответ.

Языковая модель не умеет смотреть видео. Укажите ей этот endpoint — и она получит девять инструментов для поиска по транскриптам, чтения кадров видео — слайдов, графиков, демо, текста на экране — и ответов на вопросы с цитатами, которые проверяются до того, как вы их увидите.

Никакого интеграционного кода. Никакого скрапинга. Никакого пула прокси.

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

Сервер доступен только удалённо и размещён на нашем хостинге — устанавливать или разворачивать на своей стороне нечего. Этот репозиторий — публичный манифест, справочник по конфигурации и трекер задач для этого endpoint.

Быстрый старт

Получите бесплатный токен: создайте аккаунт на 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 для входа и показывает экран согласия, где точно сказано, на что запрашивается доступ. Сама по себе регистрация не даёт ничего — доступ начинается только после того, как вошедший пользователь нажимает Approve, а активные подключения можно отозвать из вашего раздела API с мгновенным эффектом.

Клиенты без поддержки пользовательских заголовков, и Docker

В этом репозитории также есть небольшой stdio-прокси (src/index.js), который говорит по MCP через stdin/stdout и пересылает вызовы инструментов на размещённый endpoint. Используйте его, когда ваш клиент не может отправить собственный 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 переопределяет endpoint, если вы указываете не на рабочее окружение.

Универсальный мост 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

Девять инструментов

Предпочитайте search_transcript, а не get_transcript

Оба инструмента стоят один кредит на