mc-translator-mcp

Herramienta MCP para traducir al chino los modif Minecraft

Extrae automáticamente los archivos de idioma del archivo jar del mod, llama a 通义千问 para la traduction por lotes y genera un paquete de recursos en chino.

Instalación

cd mc-translator-mcp
pip install -e .

Related MCP server: NetEase ModSDK MCP Server

Configuración

Copia .env.example a .env and completa tu una API Key de 通义千问：

cp .env.example .env
# 编辑 .env，填入 DASHSCOPE_API_KEY

Solicita tu API Key: [Consola de阿里云百炼]（https://bailian.console.aliyun.com/）

Métodos de inicio

Como servidor MCP (rcomendado)

python -m mc_translator_mcp

Configura el servidor MCP en Trae/Claude Desktop:

{
  "mcpServers": {
    "mc-translator-mcp": {
      "command": "python",
      "args": ["-m", "mc_translator_mcp"]
    }
  }
}

Modo CLI

# 检查 jar 语言文件
python -m mc_translator_mcp check <jar_path>

# 翻译单个 jar
python -m mc_translator_mcp mod <jar_path> [--batch-size 15] [--force-retranslate]

# 批量翻译目录下所有 jar
python -m mc_translator_mcp dir <directory> [--glob "*.jar"] [--batch-size 15]

Ejemplo de uso

Usar las herramientas MCP en el chat de Trae

Di directamente a Trae:

"Ayúdame a traducir este mod: /path/to/mymod.jar"

Trae llamará automáticamente a la herramienta MCP translate_mod o translate_all_mods_in_directory.

Ejecución local

# 翻译单个模组
python -m mc_translator_mcp mod "C:/Users/kjds/Desktop/mods/myzombie.jar" --batch-size 20

# 批量翻译整个 mods 目录
python -m mc_translator_mcp dir "C:/Users/kjds/Desktop/.minecraft/mods" --glob "*.jar"

Salida

Por defecto, la salida se genera en el directorio output/, and cada mod genera su propio paquete de recursos:

output/
├── mymod-zh-cn/
│   ├── pack.mcmeta
│   └── assets/mymod/lang/zh_cn.json
├── zombie_mod-zh-cn/
│   ├── pack.mcmeta
│   └── assets/zombie_mod/lang/zh_cn.json
└── ...

Carga: copia la carpe ta output/<modid>-zh-cn/ al directorio resourcepacks/ de Minecraft.

Módulos principales

Pruebas

python -m pytest tests/ -v

Principios de diseño

1. Prioridad del paquete de recursos: por defect tue, genera un paquete de recursos independiente, sin dañir el archivo jar original.

2. Caché inteligente: las entradas con el maismo texto + modid original se traduen una sola vez, again.

3. Sipar chino ya localizado: cuando exists un zh_zh_cn.json no se verse, lo omite automáticamente para no sobrescrib ir las traducciones de la comunidad.

4. Traducción por lotes: cada lote, máxim máx. de BATCH entradas, la API devuelve todos los resultados en una واحدةNo: "4. Traducción por lotes: cada lote tiene un máximo de BATCH_SIZE entradas y una sola llamad a la API devuelve todos los resultados."

5. Compatibilidad de formatos: compatibles con formatos .json (modern) and .lang (traditional) para archivos de idioma.