# Game Translator

> Game Translator is an open-source MCP server for translation quality. MCP server that translates plain-text game and mod files into Chinese via any. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/dcd887/game-translator-mcp
- **MCP Registry name:** io.github.dcd887/game-translator
- **Categories:** translation quality
- **Listing updated:** 2026-11-18

## About

The README describes this as a callable localization capability for AI agents rather than standalone translation software. It scans a game or mod directory for plain-text files, sends the strings to a translation model in batches, and writes the results to a separate output folder so the original game files stay untouched.

The project supports a long list of text formats, including JSON, TSV, VDF, PO, srt/ass subtitles and Ren'Py scripts, and the README lists Minecraft mods, Euro Truck Simulator 2 and Source-engine games among the typical targets. Binary packs such as .pak or .locres files are out of scope and need unpacking first, as the README states.

The server needs Python 3.10 or newer and a user-supplied API key for an OpenAI-compatible provider. A preview command estimates the workload and token use before any translation call is made. The README says the output is licensed for personal, non-commercial use.

## Features

- **Multi-format text parsing:** Reads many plain-text localization formats, including JSON, VDF, PO, TSV and subtitle files.
- **Batch translation:** Sends up to a configurable number of entries per request to reduce API calls and token use.
- **Translation cache:** Stores results keyed by a hash of each source string so repeated text is translated once.
- **Free preview mode:** Scans files and estimates entry counts and tokens without calling the model or writing files.
- **Non-destructive output:** Writes translated files to a separate directory by default and keeps the original game files intact.
- **Provider-agnostic setup:** Works with any OpenAI-compatible endpoint configured through environment variables.

## Good for

- Translating a Minecraft mod's language JSON files into Chinese
- Localizing plain-text strings in a Source-engine or Steam game
- Translating Ren'Py visual novel scripts or SRT subtitle files
- Estimating translation cost before running a full localization job

## Install

### Claude Code (Terminal)

```sh
claude mcp add game-translator -- uvx game-translator-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "game-translator": {
      "command": "uvx",
      "args": [
        "game-translator-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "game-translator": {
      "command": "uvx",
      "args": [
        "game-translator-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "game-translator": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "game-translator-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "game-translator": {
      "command": "uvx",
      "args": [
        "game-translator-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "game-translator": {
      "command": "uvx",
      "args": [
        "game-translator-mcp"
      ]
    }
  }
}
```

## Tools

- `preview_translate_game`: Zero-cost preview that lists files, entry counts and estimated tokens without calling AI or writing files.
- `scan_game_directory`: Scans a directory and returns translatable files with a text volume estimate.
- `translate_game`: Runs the full flow: scan, AI translation, write-back and report generation.
- `dry_run_translate`: Translates a small sample for preview without writing files.
- `list_steam_games`: Finds installed Steam games that have translatable text.

## FAQ

### Does it work with binary asset packs?

No. The README says .pak, .vpk and similar binary resources must be unpacked before they can be processed, and .locres files need UnrealPak.

### Which AI provider does it use?

It does not bind to one vendor. Users supply a key and base URL for any OpenAI-compatible provider, or use one of the named providers the README lists.

### Does it overwrite the original game files?

By default no. It runs in copy mode and writes results to a separate output directory, and the README describes a manual step for putting the files back into the game.

### What is the default file size limit?

The default is 10MB per text file, and it can be raised with a command-line flag or the SCAN_MAX_SIZE_MB environment variable.

### Is Game Translator free?

Yes. Game Translator is open source, so you can use and self-host it for free.

### How do I add Game Translator to Claude Code?

Run this command in your terminal: claude mcp add game-translator -- uvx game-translator-mcp

### What are the best alternatives to Game Translator?

The closest alternatives to Game Translator are Mc Translator and Translation Services Mcp.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Mc Translator](https://ai-powered.com/mcp/mc-translator): Mc Translator is an open-source MCP server for games and play.
- [Translation Services Mcp](https://ai-powered.com/mcp/translation-services-mcp): Translation Services Mcp is a freemium MCP server for translation quality.

---
Source: https://ai-powered.com/mcp/game-translator
