VidWords YouTube MCP 서버

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

아홉 가지 도구

get_transcript보다 search_transcript를 선호하세요

둘 다 동영상당 1크레딧이므로 비용상 이유로 선택할 것은 없습니다. 이유는 컨텍스트입니다. "이 2시간 인터뷰에서 가격에 대해 뭐라고 했나요?"라고 물으면 get_transcript는 약 20,000단어를 반환하며, 그중 가격에 관한 것은 아마 300단어 정도일 것입니다 — 그 300단어는 관련 없는 19,700단어와 주목을 두고 경쟁하게 되고, 답변은 더 나빠지고, 더 느려지고, 생성 비용도 더 높아집니다.

search_transcript는 각각 딥 링크가 있는 일치 구간만 반환합니다. 전체 텍스트가 정말로 필요할 때 — 내보내기, diff, 말뭉치 — get_transcript를 사용하세요.

자막뿐만 아니라 화면도 읽습니다

analyze_video는 말로 표현되지 않는 슬라이드, 차트, 코드 샘플 및 화면 속 텍스트를 살펴봅니다. 그런 다음 ask_video는 저장된 분석을 바탕으로 답변하며, 모든 인용문은 표시되기 전에 검증됩니다: 시각적 주장은 실제로 기록된 프레임과 일치해야 하고, 음성 주장은 실제 트랜스크립트 구간에 해당해야 합니다. 실패한 것은 모두 삭제되며, 아무것도 살아남지 못하면 답변은 확신에 찬 추측을 내놓는 대신 증거가 불충분하다고 말합니다.

그것은 때때로 짜증날 수 있습니다 — 거절은 유창한 답변보다 못한 데모입니다 — 그리고 이것이 에이전트 앞에 놓아도 안전한 유일한 버전입니다. 에이전트는 인간 독자가 적용하는 회의적 태도 없이 들은 것을 반복하기 때문입니다.

인증, 비용 및 제한

• Bearer가 아닌 Basic. 토큰은 그대로 전송됩니다. user:pass 쌍을 base64로 인코딩하지 않습니다.

• 먼저 이메일을 인증하세요. 인증 링크를 클릭하기 전까지 모든 호출은 403과 {"error":"email_unverified"}를 반환합니다 — 새 계정에서 가장 흔한 첫 호출 실패입니다.

• 크레딧은 REST API 및 웹사이트와 공유되는 하나의 풀입니다. 1크레딧은 트랜스크립트 1개입니다. 프레임 분석은 대신 Watch 시간을 사용하며, 시작 전에 거부된 실행은 비용이 들지 않습니다.

• 속도 제한: 10초당 30회 요청 — REST API의 5회보다 의도적으로 느슨합니다. 서버가 무상태(stateless)이고 클라이언트가 모든 호출 전에 initialize를 다시 실행하기 때문입니다. analyze_video는 REST 경로와 공유되는 분당 10회 시작이라는 자체 상한이 있습니다.

• RapidAPI 토큰은 여기서 거부됩니다. 해당 ID는 호출당 과금되며 그 뒤에 계정이 없으므로, 둘 다 도구 호출 세션에서 유지되지 않습니다. VidWords API 토큰을 사용하세요.

• 설계상 무상태(stateless). 재개 가능한 SSE 스트림도, 삭제할 세션도 없습니다. 모든 도구는 한 번에 응답합니다. GET과 DELETE는 HTML 404 대신 JSON-RPC 오류를 반환합니다.

• 자막이 존재해야 합니다. 자막 트랙이 없는 동영상의 경우, 로그인한 계정이 대신 오디오에서 트랜스크립션할 수 있습니다 — 길이에 따라 가격이 책정되며, 지출 전에 견적이 제공됩니다.

전체 수치: 가격.

문서

• YouTube MCP 서버 — 개요

• Claude Code 설정

• Claude Desktop 설정

• Cursor 설정

• REST API 문서

지원

MCP 표면에 관한 모든 것은 여기에 이슈를 열어주세요 — 오작동하는 도구, 문서화되지 않은 클라이언트 구성, 더 명확해질 수 있는 스키마 등. 계정 및 결제 문의는 지원으로 보내주세요.

라이선스

이 저장소의 내용(문서 및 구성 예제)은 MIT 라이선스입니다. 호스팅 서비스 자체는 독점이며 VidWords 약관이 적용됩니다.

독립 제품입니다. YouTube 또는 Google과 제휴 관계가 없습니다.