tvsub MCP

Name: tvsub MCP
Author: launzi

de launziversión 0.3.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.launzi/tvsub-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: ANTHROPIC_API_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: ANTHROPIC_API_KEY

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "tvsub": {
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "your-value"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add tvsub --env ANTHROPIC_API_KEY=your-value -- uvx tvsub-mcp --tvsub-root your-value

Completa los valores vacíos antes de ejecutarlo.

Este necesita valores en su línea de comandos, así que copia la configuración y complétalos.

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "tvsub": {
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "your-value"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este necesita valores en su línea de comandos, así que copia la configuración y complétalos.

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "tvsub": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tvsub-mcp",
        "--tvsub-root",
        "your-value"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

ANTHROPIC_API_KEY secreto env
Anthropic API key; required only for subtitle translation

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub launzi, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32708 servidores de esta categoría
Publicado en el registro más recientemente que el 70% de los otros 32708 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32708 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro tvsub MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: ANTHROPIC_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.3.0) llegó al registro hace 16 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, OpenTakeoff

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

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

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

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

Se ejecuta en la nube★ 211Actualizado anteayer

Instalar

OpenTakeoff

de Kentucky-ai

Construction takeoff for AI agents: load plans, set scale, measure, count, export with provenance.

Se ejecuta en tu computadoraActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

OpenTakeoff

README del creador

tvsub MCP

Two directions, one workflow

Requirements

Install and register with Claude Code

Tools

Usage statistics

Important notices

Development

License