tvsub MCP

Name: tvsub MCP
Author: launzi

von launziVersion 0.3.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.launzi/tvsub-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: ANTHROPIC_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: ANTHROPIC_API_KEY

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

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

Führe das in deinem Terminal aus

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

Trag die leeren Werte ein, bevor du ihn startest.

Dieser Server braucht Werte in seiner Befehlszeile, also kopier die Einstellungen und trag sie ein.

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server braucht Werte in seiner Befehlszeile, also kopier die Einstellungen und trag sie ein.

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

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

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto launzi bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32683 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 70 % der anderen 32683 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32683 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist tvsub MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: ANTHROPIC_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.3.0) kam vor 16 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, MCP Server Autocad Lisp Helper

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

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

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

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

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

MCP Server Autocad Lisp Helper

von radwanalmsora

High-precision static analysis and debug server for AutoCAD AutoLISP (.lsp) files.

Läuft auf deinem ComputerAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

MCP Server Autocad Lisp Helper

README vom Entwickler

tvsub MCP

Two directions, one workflow

Requirements

Install and register with Claude Code

Tools

Usage statistics

Important notices

Development

License