tvsub MCP

Name: tvsub MCP
Author: launzi

โดย launziรุ่น 0.3.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.launzi/tvsub-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Control tvsub for Apple TV.app: subtitles, glossary-aware translation, overlay, styling, and sync.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: อื่น ๆ
ต้องใส่ค่าเหล่านี้: ANTHROPIC_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: ANTHROPIC_API_KEY

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "tvsub": {
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "ใส่ค่าของคุณ"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add tvsub --env ANTHROPIC_API_KEY='ใส่ค่าของคุณ' -- uvx tvsub-mcp --tvsub-root 'ใส่ค่าของคุณ'

เติมค่าที่เว้นว่างไว้ก่อนรัน

ตัวนี้ต้องใส่ค่าในคำสั่งเปิดเอง ให้คัดลอกค่าตั้งแล้วเติมค่า

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "tvsub": {
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "ใส่ค่าของคุณ"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

ตัวนี้ต้องใส่ค่าในคำสั่งเปิดเอง ให้คัดลอกค่าตั้งแล้วเติมค่า

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "tvsub": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "ใส่ค่าของคุณ"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

ANTHROPIC_API_KEY ความลับ env
Anthropic API key; required only for subtitle translation

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub launzi ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด อื่น ๆi

ดาวมากกว่า 0% ของอีก 32678 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 70% ของอีก 32678 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 32678 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

tvsub MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: ANTHROPIC_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.3.0) เข้า registry 16 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Spec Driven Development, Remote Desktop Commander, Starreel

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Spec Driven Development

โดย formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

รันบนเครื่อง★ 440MITอัปเดต 14 เดือนที่ผ่านมา

ติดตั้ง

Remote Desktop Commander

โดย desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

รันบนคลาวด์★ 211อัปเดต เมื่อวานซืน

ติดตั้ง

Starreel

โดย starreel

Turn a script into a finished, downloadable short-drama episode — via MCP or REST.

รันบนเครื่องอัปเดต วันนี้

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

tvsub MCP

tvsub-mcp is the MCP companion for tvsub, an experimental subtitle overlay for Apple TV.app on macOS. It lets an MCP client inspect the current playback item, choose or translate a subtitle file, adjust its appearance, start or stop the overlay, and calibrate subtitle timing.

Supported player: purchased and rented films in macOS Apple TV.app (Prime Video support is being explored and is not currently available). Subtitle formats: SRT, SMI/SAMI, VTT. Translation runs on your choice of three backends: an Anthropic API key, a signed-in Claude Code CLI (Claude subscription), or a signed-in Codex CLI (ChatGPT subscription) — subscription backends add no API charges.

The server does not download subtitles, bypass DRM, modify video, or launch TV.app. You provide subtitle files that you have the right to use and start playback yourself.

Two directions, one workflow

If a foreign, classic, or multilingual film you purchased in Apple TV.app does not include Korean—or another language you need—bring a lawfully obtained subtitle file, translate it with your Claude or ChatGPT subscription, and display it as an overlay. The same workflow works in the other direction: viewers worldwide can translate lawfully obtained subtitles for Korean films and series into their own language.

Apple TV.app에서 구매한 외화·고전·다국어 영화에 한국어 또는 원하는 언어 자막이 없다면, 정당하게 보유한 자막 파일을 불러와 Claude나 ChatGPT 구독으로 번역한 뒤 오버레이로 표시할 수 있습니다. 같은 방식으로 전 세계 시청자도 한국 영화와 시리즈의 정당하게 보유한 자막을 자신의 언어로 번역해 시청할 수 있습니다.

Requirements

macOS
tvsub, installed and built
Python 3.12 or later
uv for the recommended uvx installation
For subtitle translation, one of: an Anthropic API key, a signed-in Claude Code CLI (Claude subscription), or a signed-in Codex CLI (ChatGPT subscription). No key or CLI is needed for any other tool

Install and register with Claude Code

Replace /absolute/path/to/tvsub with the directory containing tvsub's build/, config/, src/, and subtitles/ directories.

brew install uv

claude mcp add --transport stdio --scope user tvsub -- \ uvx tvsub-mcp==0.3.0 \ --tvsub-root /absolute/path/to/tvsub

claude mcp get tvsub claude mcp list

Translation picks a backend automatically: an Anthropic API key if present, then a signed-in Claude Code CLI, then a signed-in Codex CLI. Set TVSUB_TRANSLATE_BACKEND (auto, api, claude, codex) or the backend tool argument to override. With a subscription CLI signed in you can skip the key entirely. To use the API backend, export your key and include it when registering the server — or store it once in macOS Keychain (service kim.youngji.tvsub.anthropic), which the server also reads.

export ANTHROPIC_API_KEY="your-key"

claude mcp add --transport stdio --scope user \ --env ANTHROPIC_API_KEY="$ANTHROPIC_API_KEY" \ tvsub -- uvx tvsub-mcp==0.3.0 \ --tvsub-root /absolute/path/to/tvsub

Other stdio MCP clients can launch the same command:

uvx tvsub-mcp==0.3.0 --tvsub-root /absolute/path/to/tvsub

Tools

Tool	Purpose
`now_playing`	Read the current Apple TV.app title, content ID, position, and playback state.
`list_subtitles`	List and parse SRT, SMI, SAMI, and VTT files in tvsub's subtitle library.
`load_subtitle`	Select a subtitle file for the current content while preserving sync anchors by default.
`translate_subtitle`	Estimate or perform an LLM translation with cue and timecode validation. Supports backend selection, glossary injection, and partial retranslation by line or time range.
`set_glossary`	Create or update a per-title glossary (names, honorifics, relationships, forbidden translations) that is injected into translation prompts.
`mark_reviewed`	Promote a translated subtitle's provenance from `ai_draft` to `user_reviewed`.
`list_fonts`	List installed macOS fonts and check sample glyph coverage.
`set_style`	Change font, size, colors, outline, background, and screen position.
`start_overlay`	Start tvsub with the selected subtitle and style.
`stop_overlay`	Stop only the overlay process started by this server.
`calibrate_sync`	Store one or more dialogue anchors and calculate timing offset and drift.
`status`	Summarize playback, overlay, subtitle, style, and calibration state.

Before translating, call translate_subtitle with dry_run=true to review the cue count, batch count, and estimated cost. Subscription backends report $0 (included in subscription). Every translation writes a .provenance.json sidecar recording backend, hashes, and review status.

Usage statistics

Starting with 0.2.3, anonymous usage statistics are enabled by default. The server stores a random installation ID (UUIDv4), daily tool and translation backend counts, and send dates in ~/Library/Application Support/tvsub/telemetry.json. The first enabled run prints a notice to stderr; the status tool reports whether collection is enabled, what is sent, and how to disable it.

On startup and after tool calls, the server checks for unsent days before today. It sends the oldest pending day in a background POST to https://youngji.kim/api/tvsub/telemetry, at most once per local calendar day. The timeout is 3 seconds. Failed attempts keep their counters and retry on the next eligible day; they do not interrupt tools. TVSUB_TELEMETRY_URL overrides the collector URL.

The JSON contains only install_id, day, tvsub_mcp_version, macos_version (major.minor), python_minor (major.minor), tools (counts for the 12 tool names), and backends (counts for api, claude, codex, pro, or auto). An omitted or empty backend is counted as auto; this records the requested backend, not the backend eventually selected by translation. Statistics never include subtitle text, titles, content IDs, filenames, paths, glossaries, API keys, raw errors, or IP addresses in the payload.

To disable both recording and sending, set `TVSUB_TELEMETRY=0` (false, off, and no also work, case-insensitively), or `DO_NOT_TRACK=1` in the MCP server's environment. For example, add --env TVSUB_TELEMETRY=0 to the claude mcp add command before tvsub. Mock mode (--mock or TVSUB_MCP_MOCK=1) and tests always disable statistics. Disabling leaves any existing local counters untouched; no statistics are recorded or sent while disabled.

Important notices

Experimental software: expect rough edges and breaking changes. Keep a backup of your tvsub configuration and subtitle files.
Data sent to Anthropic: translation sends the selected subtitle text and surrounding subtitle context to the Anthropic API. Loading, styling, sync, and overlay controls do not send subtitle text to Anthropic.
User-paid API usage: the api backend uses your Anthropic API key and all charges are your responsibility; estimates can differ from the final bill. The claude and codex backends run through your own signed-in subscription CLIs and add no API charges.
Private API risk: tvsub reads Apple playback state through undocumented macOS MediaRemote interfaces. Apple does not support this integration and a macOS update may change or disable it.
Content rights: you are responsible for having the right to process and translate subtitle files. Do not redistribute protected content without permission.
This project is independent from and not affiliated with Apple or Anthropic.

Development

python3.12 -m venv .venv

.venv/bin/python -m pip install -e . .venv/bin/python -m unittest discover -s tests -p 'test_*.py' -v TVSUB_TEST_PYTHON="$PWD/.venv/bin/python" .venv/bin/python tests/stdio_smoke.py bash scripts/hygiene-check.sh

Before tagging a release, run bash scripts/preflight.sh from the repository root.

Linux can run the unit tests and mock stdio smoke test. Apple TV.app, MediaRemote, CoreText, and the real overlay require macOS.

License

MIT. See LICENSE.

tvsub MCP

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด อื่น ๆi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Spec Driven Development

Remote Desktop Commander

Starreel

README จากผู้ทำ

tvsub MCP

Two directions, one workflow

Requirements

Install and register with Claude Code

Tools

Usage statistics

Important notices

Development

License