home / mcp / translate srt mcp server

Translate SRT MCP Server

Translates SRT subtitles to Japanese using a local LM Studio–backed model, with chunked processing, validation, and usage analytics.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sumik5-translate-srt-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/sumik5/translate-srt-mcp",
        "translate-srt-mcp"
      ],
      "env": {
        "CHUNK_SIZE": "1000",
        "LM_MODEL_NAME": "llama-3.2-3b-instruct",
        "LM_STUDIO_URL": "http://localhost:1234"
      }
    }
  }
}

You translate SRT subtitle files into Japanese using a local LM Studio–backed MCP server. It preserves timing, supports large files through chunking, offers analysis and previews, and provides robust error handling and usage statistics so you can translate efficiently and track your usage.

How to use

Set up the MCP server locally and connect your MCP client to translate SRT subtitles into Japanese. Use the available tools to check the LM Studio connection, analyze SRT content, preview translations, translate, and inspect server statistics.

How to install

Prerequisites you need before installation:

- Python 3.13 or newer.

- LM Studio or an OpenAI‑compatible API server.

- A package manager capable of running MCP servers (uvx is recommended).

Choose one of the following installation methods.

Method 1: using uvx (recommended and simplest)

# Quick test run using the provided MCP server
uvx --from git+https://github.com/sumik5/translate-srt-mcp translate-srt-mcp

# Or run with environment variables for LM Studio and a model
LM_STUDIO_URL="http://localhost:1234" \
LM_MODEL_NAME="grapevine-AI/plamo-2-translate-gguf" \
uvx --from git+https://github.com/sumik5/translate-srt-mcp translate-srt-mcp

Method 2: local installation

# Clone the MCP server repository
git clone https://github.com/yourusername/translate-srt-mcp.git
cd translate-srt-mcp

# Install dependencies with uv
uv sync

# Or install dependencies with pip
pip install -r requirements.txt

Available tools

check_lm_studio_status

Checks the connection to LM Studio and reports API reachability and available models.

translate_srt

Translates an SRT content string into Japanese while preserving timestamps and formatting.

analyze_srt

Analyzes an SRT file to provide statistics such as subtitle count and duration.

preview_srt

Generates a preview of translated subtitles for quick verification.

get_server_info

Returns server information and usage statistics.