# Mc Translator

> Mc Translator is an open-source MCP server for games and play. MCP server that translates Minecraft mod language files into Chinese resource packs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Windows, macOS, Linux
- **Repository:** https://github.com/dcd887/mc-translator-mcp
- **MCP Registry name:** io.github.dcd887/mc-translator
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

The README describes an MCP server that scans Minecraft mod jar files, pulls out their language files, sends the strings to a translation model in batches, and writes the results as a Chinese resource pack that can be copied into the game's resourcepacks folder. Original jars are left untouched by default.

The translator is not tied to one vendor. It reads an OpenAI-compatible endpoint from environment variables, and also lists Alibaba's DashScope (Qwen) and DeepSeek as options, with a fallback provider. Each run injects Minecraft terminology and an optional per-mod glossary file so terms stay consistent across a mod. Format placeholders and colour codes are kept as they are.

It is aimed at Minecraft players and modpack maintainers who run mods in Chinese and want to translate them in bulk. The README recommends running preview or dry-run first, since translation consumes API tokens.

## Features

- **Jar language file extraction:** Finds and reads .json, .lang and .properties language files inside mod jar archives.
- **Chinese resource pack output:** Writes a separate resource pack per mod, leaving the original jar unchanged.
- **Vendor-agnostic model config:** Works with any OpenAI-compatible endpoint, with Qwen and DeepSeek options set via .env.
- **Custom terminology glossary:** Lets you define fixed Chinese translations for mod-specific terms in a JSON file.
- **Preview and dry-run modes:** Estimates workload and token use, or translates a small sample, before a full run.
- **Batch directory translation:** Translates every jar in a mods folder in one command.

## Good for

- Translating a single Minecraft mod into Chinese as a resource pack
- Batch-translating a whole .minecraft mods directory
- Estimating token cost before committing to a large modpack translation
- Previewing translation quality on a sample of strings before a full run
- Keeping mod-specific names consistent using a custom glossary

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `translate_mod`: Translates a single mod jar's language files.
- `translate_all_mods_in_directory`: Translates all jars in a directory.
- `preview_mod`: Zero-cost preview of mods, text counts and estimated tokens.
- `dry_run_mod`: Translates a sample of entries to preview quality.

## FAQ

### Which AI providers does it support?

The README says it works with any OpenAI-compatible endpoint configured through TRANSLATOR_API_KEY, TRANSLATOR_BASE_URL and TRANSLATOR_MODEL. It also lists Alibaba DashScope (Qwen), agnes AI and DeepSeek as options, with DeepSeek as an optional fallback.

### Does it modify the original mod jar?

By default it generates a separate resource pack and does not alter the original jar. The README also lists a jar-rewriting option in the pack builder module.

### How can I check the setup before translating?

The README suggests running the dry-run command on a jar. It translates a small sample of entries, by default 20, so you can confirm the API key is loaded and the output looks right.

### How do I connect it to an MCP client?

The README gives a JSON config that runs python -m mc_translator_mcp as a command, shown for Trae and Claude Desktop.

### Is Mc Translator free?

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

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

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

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

The closest alternatives to Mc Translator are Game Translator, MCP Fabric (Minecraft) and Minecraft 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

- [Game Translator](https://ai-powered.com/mcp/game-translator): Game Translator is an open-source MCP server for translation quality.
- [MCP Fabric (Minecraft)](https://ai-powered.com/mcp/mcp-fabric-minecraft): MCP Fabric (Minecraft) is a free MCP server for games and play.
- [Minecraft MCP](https://ai-powered.com/mcp/minecraft-mcp): Minecraft MCP is an MCP server for games and play.

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