Is io.github.launzi/tvsub-mcp safe to use?

io.github.launzi/tvsub-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install io.github.launzi/tvsub-mcp?

io.github.launzi/tvsub-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What AI clients work with io.github.launzi/tvsub-mcp?

io.github.launzi/tvsub-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.launzi/tvsub-mcp actively maintained?

io.github.launzi/tvsub-mcp is actively maintained — last commit was 7 days ago.

io.github.launzi/tvsub-mcp

tvsub-mcp

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

GitHub PyPI

No known CVEs

MIT license

Actively maintained

Last commit 7d ago

Works with most clients

Transport: stdio

0 tools

Grade F

MCPpedia last refreshed this data 1h ago

Edit this pageView history

io.github.launzi/tvsub-mcp is an MCP server that control tvsub for Apple TV.app: subtitles, glossary-aware translation, overlay, styling, and sync. Its tool list has not been published yet over stdio, requires no API key, and scores 59/100 on MCPpedia's security, maintenance and efficiency rubric.

Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-launzi-tvsub-mcp": {
      "args": [
        "tvsub-mcp"
      ],
      "command": "uvx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-launzi-tvsub-mcp)](https://mcppedia.org/s/io-github-launzi-tvsub-mcp)

Read me

What io.github.launzi/tvsub-mcp does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'tvsub-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

59/100across 5 weighted dimensions

How we score →

0255075100

−41

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked tvsub-mcp against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.launzi/tvsub-mcp safe to use?: io.github.launzi/tvsub-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.launzi/tvsub-mcp?: io.github.launzi/tvsub-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.launzi/tvsub-mcp?: io.github.launzi/tvsub-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.launzi/tvsub-mcp actively maintained?: io.github.launzi/tvsub-mcp is actively maintained — last commit was 7 days ago.

Similar servers

Others in writing

View all →

Mcp Pandoc94

MCP server for document format conversion using pandoc.

576 1

Mcp Server Youtube Transcript92

This is an MCP server that allows you to directly download transcripts of YouTube videos.

583 1

io.github.xberg-io/crawlberg92

Scrape, crawl, and map websites to Markdown or JSON via local CLI.

160 5

io.github.damonwill78-a11y/clean-markdown90

Any URL to clean, LLM-ready Markdown for RAG. Strips ads, nav, and boilerplate.

MCP Security Weekly

Get CVE alerts and security updates for io.github.launzi/tvsub-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-launzi-tvsub-mcp": {
      "args": [
        "tvsub-mcp"
      ],
      "command": "uvx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-launzi-tvsub-mcp)](https://mcppedia.org/s/io-github-launzi-tvsub-mcp)

Read me

What io.github.launzi/tvsub-mcp does

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'tvsub-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

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.2.1 \
  --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.2.1 \
  --tvsub-root /absolute/path/to/tvsub

Other stdio MCP clients can launch the same command:

uvx tvsub-mcp==0.2.1 --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_re

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

59/100across 5 weighted dimensions

How we score →

0255075100

−41

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked tvsub-mcp against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.launzi/tvsub-mcp safe to use?: io.github.launzi/tvsub-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.launzi/tvsub-mcp?: io.github.launzi/tvsub-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.launzi/tvsub-mcp?: io.github.launzi/tvsub-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.launzi/tvsub-mcp actively maintained?: io.github.launzi/tvsub-mcp is actively maintained — last commit was 7 days ago.