mc-translator-mcp

MCP-инструмент для перевода модов Minecraft на китайский язык

Автоматически извлекает языковые файлы из jar-файла мода, вызывает 通义千问 для пакетного перевода и создаёт ресурс-пак на китайском языке.

Установка

cd mc-translator-mcp
pip install -e .

Related MCP server: NetEase ModSDK MCP Server

Настройка

Скопируйте .env.example в .env и заполните свой API-ключ 通义千问:

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

Получить API-ключ: консоль 阿里云百炼

Способы запуска

В качестве MCP-сервера (рекомендуется)

python -m mc_translator_mcp

Настройте MCP-сервер в Trae/Claude Desktop:

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

Режим 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]

Примеры использования

Использование MCP-инструментов в диалоге с Trae

Просто скажите Trae:

Помоги перевести этот мод: /path/to/mymod.jar

Trae автоматически вызовет translate_mod или translate_all_mods_in_directory из MCP-инструментов.

Локальный запуск

# 翻译单个模组
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"

Вывод

По умолчанию результат выводится в каталог output/, для каждого мода генерируется отдельный ресурс-пак:

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
└── ...

Для подключения скопируйте папку output/<modid>-zh-cn/ в каталог resourcepacks/ в Minecraft.

Основные модули

Тестирование

python -m pytest tests/ -v

Принципы проектирования

1. Приоритет ресурс-пака: по умолчанию создаётся отдельный ресурс-пак, исходный jar-файл не изменяется.

2. Интеллектуальный кэш: записи с одинаковым исходным текстом и modid переводятся только один раз, чтобы не тратить токены повторно.

3. Пропуск существующих переводов: при обнаружении уже существующего zh_cn.json автоматически пропускается, чтобы не перезаписывать перевод сообщества.

4. Пакетный перевод: не более BATCH_SIZE записей за партию, все результаты возвращаются одним вызовом API.

5. Совместимость форматов: поддерживаются языковые файлы в форматах .json (современном) и .lang (традиционном).