renpy-translate-mcp

MCP server for translating Ren'Py visual novels. Extracts dialogue, prepares translation batches with glossary/context, and generates official tl/ translation files.

Features

• Extract all translatable strings — say statements, menu choices, character names, screen text, _() strings
• Smart translation batching — context windows, character speech style profiles, glossary term injection
• Safe tl/ file generation — never modifies original .rpy files (preserves save compatibility)
• Glossary management — terms, character profiles (honorifics/speech style), font settings
• CJK font support — auto-generates style.rpy with font overrides

Installation

npm install -g renpy-translate-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "renpy-translate": {
      "command": "npx",
      "args": ["renpy-translate-mcp"]
    }
  }
}

Tools

extract_dialogue

Extract all translatable strings from .rpy files in a game directory.

Parameters:

• gameDir (required) — absolute path to game directory
• files — specific .rpy files to parse
• skipTranslated — skip already translated strings
• language — target language (for skipTranslated)

translate_dialogue

Prepare extracted dialogue for translation with context windows, character profiles, and glossary.

Parameters:

• gameDir (required) — game directory (loads glossary)
• entries (required) — JSON string of extracted entries
• targetLanguage (required) — target language
• batchSize — entries per batch (default: 20)
• contextWindow — context lines (default: 2)

generate_translation_files

Write translations to Ren'Py tl/ directory. Never modifies original files.

Parameters:

• gameDir (required) — game directory
• language (required) — language code
• translations (required) — JSON string of translated entries
• merge — merge with existing translations (default: true)

manage_glossary

CRUD for translation glossary (terms, character profiles, fonts).

Parameters:

• gameDir (required) — game directory
• action (required) — get, add_term, remove_term, add_character, remove_character, set_fonts
• key — term or character key
• value — translation, JSON profile, or JSON font map

Quick Start

1. Open your Ren'Py game folder in Claude Code / Cursor
2. "Extract all dialogue from this game"
3. "Translate these to Korean"
4. "Generate the translation files"

License

MIT