TranscriptDock MCP server
2026년 11월 2일 커밋AI 에이전트가 YouTube, TikTok, Instagram 영상의 전사 작업을 제출하고 전사본을 가져올 수 있도록 지원합니다.
다른 이름 TranscriptDock/transcriptdock-mcp
- 스타
- 0
- Tools
- 13
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- MIT
TranscriptDock MCP란?
AI 에이전트가 YouTube, TikTok, Instagram 영상의 전사 작업을 제출하고 전사본을 가져올 수 있도록 지원합니다. 13개 도구를 제공합니다. 예: get_video_transcript, transcribe, get_job.
프로젝트 README에서 생성된 요약
TranscriptDock MCP server 정보
이 MCP server는 Claude, Cursor 또는 Claude Code를 사용하는 개발자가 AI 채팅 내에서 소셜 미디어 영상의 텍스트를 직접 추출할 수 있게 해줍니다. TranscriptDock API를 연결하는 브릿지 역할을 하며, 에이전트가 YouTube, TikTok, Instagram의 콘텐츠를 처리할 수 있도록 지원합니다. 사용자는 간편한 연결을 위해 OAuth 2.1을 사용하는 원격 설정 방식이나, td_live_로 시작하는 특정 API 키가 필요한 npx 기반의 로컬 설치 방식 중 하나를 선택할 수 있습니다.
이 server는 전체 전사 라이프사이클을 관리하기 위한 도구 모음을 제공합니다. get_video_transcript를 사용하여 제출과 조회를 한 번에 처리하거나, transcribe, get_job, wait_for_job과 같은 세분화된 도구를 사용하여 진행 상황을 모니터링할 수 있습니다. 또한 search_youtube, list_channel_videos, list_tiktok_user_videos를 통한 콘텐츠 탐색도 지원하므로, 인터페이스를 벗어나지 않고도 미디어를 찾아 처리할 수 있습니다. 요금제에 따라 captions_only 모드로 기존 캡션에 접근하거나 AI 생성 전사본을 요청할 수 있습니다.
활용 사례
- 1소셜 미디어 영상 전사AI 에이전트에게 특정 YouTube 또는 TikTok 링크를 텍스트 전사본이나 SRT 파일로 변환하도록 요청합니다.
- 2채널 콘텐츠 탐색 및 처리특정 YouTube 채널의 최신 영상을 찾아 첫 번째 영상을 전사합니다.
- 3전사 진행 상황 모니터링고유 ID를 사용하여 특정 전사 작업의 현재 상태나 오류 상세 정보를 확인합니다.
- 4특정 영상 주제 검색YouTube에서 특정 주제를 검색하고 에이전트가 가장 관련성 높은 결과물을 전사하도록 합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
TranscriptDock MCP 도구 13
README에서 감지됨get_video_transcripttranscribeget_jobget_transcriptlist_jobswait_for_jobsearch_youtubelist_channel_videosget_channel_latest_videossearch_channel_videoslist_playlist_videoslist_tiktok_user_videos
| get_video_transcript | — | |
| transcribe | — | |
| get_job | — | |
| get_transcript | — | |
| list_jobs | — | |
| wait_for_job | — | |
| search_youtube | — | |
| list_channel_videos | — | |
| get_channel_latest_videos | — | |
| search_channel_videos | — | |
| list_playlist_videos | — | |
| list_tiktok_user_videos | — |
도구 13개 모두 보기도구 수 줄이기
get_video_discovery
| get_video_discovery | — |
구성
TRANSCRIPTDOCK_API_KEYTRANSCRIPTDOCK_BASE_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| TRANSCRIPTDOCK_API_KEY | — | |
| TRANSCRIPTDOCK_BASE_URL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능transcriptdock/transcriptdock-mcp is public and reachablegithub.com/transcriptdock/transcriptdock-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-02github.com/transcriptdock/transcriptdock-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음13 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기TranscriptDock MCP server
An MCP server that wraps the TranscriptDock public API, so Claude, Cursor and other agents can submit transcription jobs and read back transcripts without you leaving the chat.
It only calls the public /v1 API (API reference). The hosted server signs you in with OAuth; the local one needs a TranscriptDock API key (td_live_...).
Remote (no install)
The hosted server is https://www.transcriptdock.com/mcp (Streamable HTTP). Use that exact URL: the apex domain redirects, and clients drop the Authorization header on a cross origin redirect.
Claude (claude.ai, Desktop, mobile)
Open Customize, Connectors, choose Add custom connector, and paste https://www.transcriptdock.com/mcp. Choose Add, then Connect, sign in to TranscriptDock and allow access. No API key needed: the server publishes RFC 9728 metadata and signs people in through OAuth 2.1 (dynamic client registration, S256 PKCE). An OAuth connection can read and submit jobs and read transcripts, nothing else.
Claude Code and other clients
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp
Then run /mcp and choose Authenticate. To use an API key instead, send it as a bearer header:
claude mcp add --transport http transcriptdock https://www.transcriptdock.com/mcp \
--header "Authorization: Bearer td_live_..."
{ "mcpServers": { "transcriptdock": { "url": "https://www.transcriptdock.com/mcp", "headers": { "Authorization": "Bearer td_live_..." } } } }
Ask for a video and the agent calls get_video_transcript(url): submit, wait, text back in one tool call.
Install locally (npx)
Claude Desktop (stdio)
Claude Desktop users can add the remote connector above instead. For the local server, add this to your Claude Desktop config (Settings, Developer, Edit config):
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_...",
"TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
}
}
}
}
Claude Code
claude mcp add --transport stdio transcriptdock --env TRANSCRIPTDOCK_API_KEY=td_live_... --env TRANSCRIPTDOCK_BASE_URL=https://www.transcriptdock.com -- npx -y @transcriptdock/mcp
Cursor
Add a server in Cursor Settings, MCP, using the same command and environment variables:
{
"mcpServers": {
"transcriptdock": {
"command": "npx",
"args": ["-y", "@transcriptdock/mcp"],
"env": {
"TRANSCRIPTDOCK_API_KEY": "td_live_...",
"TRANSCRIPTDOCK_BASE_URL": "https://www.transcriptdock.com"
}
}
}
}
Sources and modes
mode defaults to captions_only: the existing captions of a YouTube or TikTok video, 1
credit each. AI transcription (auto/transcribe modes, 2 credits per started minute)
needs a paid plan, so the trial answers 402 PLAN_REQUIRED. Instagram Reels (beta) have no
caption path: send them with mode: "auto" or "transcribe"; captions_only answers 422
CAPABILITY_UNAVAILABLE. GET /v1/capabilities lists what your plan can do. For local
development use a loopback URL such as http://127.0.0.1:3000 for TRANSCRIPTDOCK_BASE_URL.
Configuration
| Variable | Required | Purpose |
|---|---|---|
TRANSCRIPTDOCK_API_KEY |
yes | Your workspace API key. The server exits with a clear message if it is missing. |
TRANSCRIPTDOCK_BASE_URL |
yes | Explicit HTTPS API origin, https://www.transcriptdock.com. HTTP is allowed only for loopback local development. |
Tools
get_video_transcript: submit, wait and return the transcript text (or srt, vtt, segments) in one call. Example prompt: "What does this video say?"transcribe: submit a video or audio URL and get back the created job. Example prompt: "Transcribe this YouTube link and give me the SRT."get_job: look up a job's status, stage, error, and billing by ID. Example prompt: "Check on job 11111111-1111-4111-8111-111111111111."get_transcript: fetch a completed transcript as normalized JSON segments or as a text, SRT, or VTT export. Example prompt: "Get the VTT for transcript 22222222-2222-4222-8222-222222222222."list_jobs: list jobs for the workspace, newest first, with cursor pagination. Example prompt: "Show my last 10 transcription jobs."wait_for_job: poll a job every few seconds until it succeeds, fails, or is cancelled, then return it. Example prompt: "Transcribe this TikTok and wait until it is done."search_youtube: search YouTube by query with cursor paging. Example prompt: "Search YouTube for lofi study music and transcribe the top result"list_channel_videos: list videos from one channel with cursor paging. Example prompt: "List the latest videos from @veritasium"get_channel_latest_videos: get the latest videos from one channel newest first with no cursor input. Example prompt: "Find the latest five videos on @veritasium and transcribe the first one"search_channel_videos: search within one channel by query with cursor paging. Example prompt: "Search @veritasium for black holes and transcribe the best match"list_playlist_videos: list videos from one playlist with cursor paging. Example prompt: "List the videos in this playlist and transcribe the first one"list_tiktok_user_videos: list up to 10 videos from one TikTok profile with the profile stats. TikTok search and further pages are not available. Setinclude_detailsto fetch each video page for full stats, dates, hashtags, and music. Example prompt: "List the latest TikTok videos from @tiktokuser"get_video_discovery: get one video discovery by ID. Example prompt: "Check on my latest video discovery and show the video list"
Each listing tool creates one video discovery with a generated idempotency key then polls to completion with a bounded timeout. A timeout returns the last body with a flag and a hint to call get_video_discovery. A failed discovery returns an error result with the error object.
Every response is the raw API payload, pretty printed as JSON, except get_transcript with format: text, srt, or vtt, which returns the export file body directly. API errors come back as a readable tool error with the error code, message, and request ID; the API key is never included in output.
Development
npm install
npm run typecheck
npm run build
npm test
npm run dev
License
MIT
TranscriptDock MCP 질문
TranscriptDock MCP는 어떤 도구를 제공하나요?
13개 도구를 제공합니다. 예: get_video_transcript, transcribe, get_job, get_transcript, list_jobs.
Claude Desktop에서 TranscriptDock를 어떻게 사용하나요?
커스텀 커넥터 설정에 URL을 붙여넣어 원격 커넥터를 사용하거나, npx를 사용하여 API 키와 함께 로컬에 설치할 수 있습니다.
Instagram Reels도 전사할 수 있나요?
네, 가능합니다. 다만 Instagram Reels는 'captions_only' 모드에서 사용할 수 있는 캡션 경로가 없으므로 'auto' 또는 'transcribe' 모드를 사용해야 합니다.