Game Translator

Name: Game Translator
Author: dcd887

de dcd887versión 0.2.1i★ 0iSe ejecuta en tu computadora

Nombre en el registroio.github.dcd887/game-translator

Cómo instalar

What it does

游戏文本本地化 MCP：多格式解析、批量翻译、回写

Connects Se ejecuta en tu computadora
Account or key No key needed
Category Juegos, deportes, comida y aprendizaje

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Game Translator para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "game-translator": { "command": "uvx", "args": [ "game-translator-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Game Translator aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

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

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa Game Translator y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando Game Translator o muestra una herramienta de Game Translator en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Game Translator

Game Translator se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Game Translator

Pasos para Claude →Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para Cursor →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para VS Code →Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Juegos, deportes, comida y aprendizaje que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

ShipSwift✓ ChatGPT
Anime Garden✓ ChatGPT
Summer Engine✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Game Translator para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user game-translator -- uvx game-translator-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Game Translator aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho

Pega este comando y pulsa Enter

claude mcp add --scope user game-translator -- uvx game-translator-mcp

Hecho

Escribe /mcp en Claude Code
Deberías ver Game Translator en la lista como conectado
Hecho
Pruébalo
Usa Game Translator y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando Game Translator o muestra una herramienta de Game Translator en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Game Translator para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "game-translator": { "command": "uvx", "args": [ "game-translator-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Game Translator aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa Game Translator y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando Game Translator o muestra una herramienta de Game Translator en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Game Translator para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "game-translator": { "type": "stdio", "command": "uvx", "args": [ "game-translator-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Game Translator aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa Game Translator y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando Game Translator o muestra una herramienta de Game Translator en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Game Translator💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user game-translator -- uvx game-translator-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 0
Descargas por semanai: 35/sem
Licencia i: MIT
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 0.2.1
Categoríai: Juegos, deportes, comida y aprendizaje
Publicado en el registroi: 23 oct 2026
Último cambio de códigoi: 24 oct 2026
Creador: dcd887
Paquetes: pypi: game-translator-mcp
Repo: dcd887/game-translator-mcp
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub dcd887, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 22 días
✓ Superada
Tiene licencia
Usa MIT
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo

Iniciar sesión

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Juegos, deportes, comida y aprendizajei

Más estrellas que el 0% de los otros 1504 servidores de esta categoría
Publicado en el registro más recientemente que el 55% de los otros 1504 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1504 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Game Translator?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 22 días, y la última versión (0.2.1) llegó al registro hace 23 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Anime Garden

Anime Garden MCP for anime torrent discovery.

de yjl9903En crecimiento★ 1,4 milActualizado hace 11 días

Se ejecuta en la nube✓ animes.garden

Cómo conectar

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

de aikarjalEn crecimiento↓ 1,4 mil/sem★ 86 Estrellas de todo el repositorioActualizado hace 6 días

Se ejecuta en tu computadora✓ del servicio · wilm.ai

Instalar

Lumify Sports Intelligence

Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.

de lumifyaiInicial★ 15Actualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · lumify.ai

Cómo conectar

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

de joshsymondsInicial★ 13Actualizado hace 7 meses

Se ejecuta en la nubeRepo archivado✓ del servicio · savecraft.gg

Cómo conectar

GoodWatch

Find movies and TV shows, track watches, and get suggestions based on your taste.

de alp82Inicial★ 50 Estrellas de todo el repositorioActualizado hace 26 días

Se ejecuta en la nube✓ del servicio · goodwatch.app

Cómo conectar

Anime Garden — Funciona en la nube, sin instalar nada · Sin clave
WilmAI — Se instala en tu equipo · Sin clave
Lumify Sports Intelligence — Funciona en la nube, sin instalar nada · Necesita clave
Savecraft — Funciona en la nube, sin instalar nada · Sin clave
GoodWatch — Funciona en la nube, sin instalar nada · Sin clave

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

mcp-name: io.github.dcd887/game-translator

game-translator-mcp

通用游戏汉化 MCP 工具 —— 扫描游戏目录，调用 AI 翻译，回写中文文本。

定位：一个可以被 AI Agent 调用的「汉化能力」，而非独立的汉化软件。可与 mc-translator-mcp、mc-pack-builder-mcp 等工具协同工作。

适用范围

本工具面向文本以明文文件存储的游戏/模组进行汉化，属于"文本汉化"而非"资源包注入"。

适用范围	说明
支持的文本格式	`.json` / `.lang` / `.txt` / `.ini` / `.xml` / `.yaml` / `.sii` / `.tsv` / `.vdf`（UTF-8 / UTF-16 自动 BOM 检测）/ `.csv` / `.properties` / `.po` / `.strings` / `.resx` / `.xliff` / `.rpy` / `.srt` / `.ass`
典型的适用对象	Minecraft 模组、欧洲卡车模拟器 2、Source 引擎游戏（Portal 2 / HL2 / L4D 的 VDF）、Ren'Py 视觉小说（galgame）、字幕（SRT/ASS）、gettext(.po)、Unity 明文本地化表、Steam 明文配置文件
输入	游戏根目录或任意文本文件目录
输出	独立汉化目录（copy 模式），不改动原游戏文件

📚 想知道你的游戏在被支持范围内吗？ 先看这里 → [SUPPORTED_GAMES.md](SUPPORTED_GAMES.md)（含已实测游戏、引擎→格式速查表、不支持清单）。

快速判断口诀：文案只要是明文文件就能汉化；不确定就 python -m game_translator_mcp preview <目录> 零成本看一眼。

不适用范围 / 已知限制：

Unity 打包的 .pak / .vpk / catalog.json 二进制资源，需先解包才能处理
幻兽帕鲁等使用 .locres 的 Unreal 游戏，需 UnrealPak 解包
战雷 / 绝地求生等服务端下发或加密的文本，不提供破解支持
单个文本文件超过大小阈值（默认 10MB，防误扫二进制），扫描时跳过 —— 阈值可用 `--max-size-mb N` 或环境变量 `SCAN_MAX_SIZE_MB` 调高（部分游戏明文配置刚好超 10MB 时很有用）

提示：Unity 游戏虽有大量 .json/.xml，但多数是引擎配置而非游戏文案；扫描器会如实返回，是否值得翻译由使用者判断。

使用条件

条件	说明
Python	≥ 3.10
依赖	见 `pyproject.toml`（mcp、openai、pydantic 等）
联网	必须能联网调用 AI 翻译 API
API Key	不绑定任何特定供应商。由使用者自任选一个 OpenAI 兼容供应商，提供 key / base_url / 模型名（见下方「配置」），这是翻译能力的必要前提
可移植性	纯 Python + 标准依赖，可在 Windows / macOS / Linux 本地跑通，无平台耦合
授权	汉化后的文本仅限个人学习 / 非商业用途；商用需确认游戏与模组的二次分发条款

AI 供应商完全由使用者配置（检测哪个 key 已配置就用哪个，优先级 custom > agnes > dashscope > deepseek）：

自定义 OpenAI 兼容供应商（推荐，最通用）：TRANSLATOR_API_KEY + TRANSLATOR_BASE_URL + TRANSLATOR_MODEL，任意兼容接口平台都可用
agnes ai：AGNES_API_KEY + AGNES_BASE_URL + AGNES_MODEL
通义千问：DASHSCOPE_API_KEY
DeepSeek（可选 fallback）：DEEPSEEK_API_KEY

安装

cd game-translator-mcp

pip install -e ".[dev]"

配置

复制 .env.example 为 .env 并填写你要用的供应商：

cp .env.example .env

任选一种方式（检测到哪个 key 就用哪个，优先级 custom > agnes > dashscope > deepseek）：

# 方式 A（推荐，最通用）：自定义 OpenAI 兼容供应商 —— 填你自己的 key / 网关地址 / 模型名

TRANSLATOR_API_KEY=sk-xxx TRANSLATOR_BASE_URL=https://your-gateway.example.com/v1 TRANSLATOR_MODEL=your-model

方式 B：agnes ai（也可展开为 OpenAi 兼容平台）

AGNES_API_KEY=sk-xxx

AGNES_BASE_URL=https://apihub.agnes-ai.com/v1

AGNES_MODEL=agnes-2.5-flash

方式 C：通义千问

DASHSCOPE_API_KEY=sk-your-qwen-key-here

方式 D：DeepSeek（可选，主供应商失败时 fallback）

DEEPSEEK_API_KEY=

BATCH_SIZE=15 # 每批翻译条数，越高越省 token OUTPUT_DIR=translated_output # 汉化输出目录 SCAN_MAX_SIZE_MB=10 # 单个文本文件大小阈值（MB），超过跳过；明文文件较大的游戏可调高

配置优先级：先读环境变量，其次读项目根目录 .env 文件，最后为内置默认值。

API Key 由使用者自备，自行寻求对应平台申请（如 agnes / 通义 / DeepSeek / 其它 OpenAI 兼容网关）。

可移植性：本工具不绑定任何云服务供应商，只要在目标机器配置好上述任一套 API 参数即可本地运行，适用于 CI、Docker 或任意平台。

启动方式

作为 MCP 服务器（供 AI Agent 调用）

python -m game_translator_mcp

Trae / Claude Desktop 配置示例：

"mcpServers": { "game-translator-mcp": { "command": "python", "args": ["-m", "game_translator_mcp"] } } }

LangChain Agent 集成（PYTHONPATH 指向 src/）：

"mcpServers": { "game-translator-mcp": { "command": "python", "args": ["-m", "game_translator_mcp"], "env": { "PYTHONPATH": "/path/to/game-translator-mcp/src" } } } }

CLI 模式

# 零成本预览：先看会扫到哪些文件、多少条文本、预估多少 token（不调用 AI、不写文件）

python -m game_translator_mcp preview <游戏目录路径>

若游戏的明文配置文件超过 10MB 被跳过，可用 --max-size-mb 调高阈值再扫

python -m game_translator_mcp preview <游戏目录路径> --max-size-mb 30

扫描游戏目录，列出可翻译文件

python -m game_translator_mcp check <游戏目录路径>

执行完整汉化

python -m game_translator_mcp translate <游戏目录路径> --modid mygame

预览翻译效果（抽样翻译，不写入文件）

python -m game_translator_mcp dry-run <游戏目录路径>

列出 Steam 库中的可翻译游戏

python -m game_translator_mcp steam

💡 先 preview 再 translate：翻译会消耗 token，默认输出到独立目录 translated_output/ 不会覆盖原文件。正式执行前先跑 preview 估一下工作量，避免白花 token。

MCP 工具

工具名	功能
`preview_translate_game`	零成本预览（--dry-run）：先扫出会处理哪些文件、每种格式数量、总条目数、预估 token，不调 AI、不消耗额度、不写文件
`scan_game_directory`	扫描目录，返回可翻译文件列表 + 文本量估算
`translate_game`	完整汉化流程：扫描 → AI 翻译 → 回写 → 生成报告
`dry_run_translate`	抽样预览翻译效果（会调用 AI 翻译一小部分样例），不实际写入文件
`list_steam_games`	发现本地 Steam 库中已安装的可翻译游戏

使用示例

自然语言调用（通过 Trae）

"帮我扫描一下我的 Steam 游戏里哪些有可翻译文本"

"帮我翻译 'RimWorld' 这个游戏的英文文本"

"预览一下 'Factorio' 的汉化效果，不要实际写入"

直接命令行调用

# 汉化一个模组目录

python -m game_translator_mcp translate "path/to/my-mod" --modid mymod

输出目录默认为 translated_output/

汉化报告自动生成到 translated_output/report.txt

新手怎么用（一句话版）

先预览，不花钱：python -m game_translator_mcp preview "游戏目录" → 看会翻译多少条。
觉得量合适就翻译：python -m game_translator_mcp translate "游戏目录" --modid mygame → 结果输出到 translated_output/，原文件一个都不动。
翻好了？照着下面「导入汉化」复制回游戏里，中文就生效了。

怎么把汉化「装」进游戏（导入 / 覆盖原文件教学）

本工具默认是copy 模式：只把翻译结果写到 translated_output/ 目录，绝不侵入你的原游戏文件。这样安全，但中文不会立即生效——你需要自己把汉化文件放进游戏认得到的位置。不同游戏的「位置」不一样，通常是这三种情况：

游戏类型	汉化文件该放哪	说明
我的世界模组/资源包	装成一个资源包（把 `translated_output` 里的 `.json` 按 `assets/ /lang/` 结构打包，或用 mc-pack-builder-mcp 生成），在游戏里启用该资源包	模组文案以官方资源包方式覆盖
Steam / 大多单机游戏	找到游戏目录里的原语言文件（英文的 `en_us.json` / `Localization` 文件夹），把汉化文件改名成游戏读取的那个语言名（比如 `zh_cn.json`），覆盖进去	改完重进游戏/重启生效
只有特定语言名的	作为可选语言丢进游戏的本地化目录	在游戏设置里切换语言到中文

⚠️ 覆盖前请一定留备份——这是能安全撤回去的唯一办法：

# 以某游戏的 Localization/english.json 为例：先把原文件备份，再覆盖

cp "游戏目录/Localization/english.json" "游戏目录/Localization/english.json.bak" cp "translated_output/你汉化后的文件.json" "游戏目录/Localization/english.json"

如果你不确定该放哪，直接把游戏目录 + 汉化输出目录一起发给 AI，让它帮你判断文件对应关系、给出准确的复制命令 —— 因为本工具就是给 AI Agent 调用的。

需要我把这份「导入/覆盖」说明做成逐步演示（配上具体游戏的实际路径）吗？告诉我你的游戏和目录，我就演示给你看。

输出结构

translated_output/

├── my-mod/ │ ├── assets/my-mod/lang/zh_cn.json │ └── ...（保持原目录结构） ├── rimworld/ │ ├── Assets/StreamingAssets/Localization/zh-cn.json │ └── ... └── report.txt # 汉化报告

核心模块

模块	功能
`scanner.py`	扫描游戏目录，识别可翻译文件，过滤二进制/大文件
`parser.py`	多格式文本解析器（JSON / LANG / TXT / INI / XML / YAML / SII / TSV / VDF / CSV / properties / PO / strings / resx / xliff / rpy / srt / ass）
`translator.py`	任意 OpenAI 兼容供应商批量翻译（custom / agnes / 通义 / DeepSeek）+ SHA-256 缓存
`writer.py`	回写翻译结果，保持原格式，支持 copy / inplace 两种模式
`reporter.py`	生成清晰的汉化报告（成功 / 跳过 / 失败统计）
`steam.py`	Steam 游戏发现，解析 VDF 索引文件
`mcp_server.py`	MCP 服务器入口，暴露 5 个工具供 AI Agent 调用
`cli.py`	命令行接口，支持 check / preview / dry-run / translate / steam 子命令

设计要点

智能缓存：对 {modid}::key::value 做 SHA-256 哈希，相同原文只翻译一次，结果持久化到 translator_cache.json
零成本预览：preview_translate_game 先扫文件、估条目数和 token，不调 AI、不写文件，帮你决定要不要花钱翻译
已有汉化跳过：若输出目录中已存在相同格式的翻译文件，自动跳过，避免覆盖社区翻译
批量翻译：每条请求携带最多 BATCH_SIZE 个条目，一次 API 调用返回全部结果，大幅降低 token 和延迟
供应商自适应：检测用户配置了哪个 key 就用哪个（custom > agnes > dashscope），可选 DeepSeek 做 fallback，不绑定任何一家
零侵入输出：默认 copy 模式生成独立输出目录，不修改原游戏文件

测试

python -m pytest tests/ -v

或

pytest tests/ -v

所有测试均在 Windows + Python 3.14 环境下通过（89 tests passed，含新增 8 类明文格式用例与零成本预览 preview 用例）。

真实汉化测试

结合真实游戏文件做了端到端汉化验证（使用 agnes ai），结果已归档到 tests/reports/：

✅ REPO（怪兽跑图）：Menu/HUD/Game.tsv 共 603 条，全部真实翻译并回写为 TSV，成功 602 条
✅ Portal 2：Source 引擎 VDF（UTF-16）端到端汉化，basemodui_english.txt 共 2231 条明文可翻译，回写保留 UTF-16 BOM
✅ Biped 2：localization_en.txt 明文 key=value 928 条，可直接汉化
✅ 新增明文格式：.csv / .properties / .po / .strings / .resx / .xliff / .rpy / .srt / .ass 全部做了真实翻译与回写验证；其中 .rpy/.srt/.ass 采用原位 token 回填，不破坏脚本/字幕结构
🔍 其余游戏（Isaac / Palworld / CSGO 等）：文本封装于私有资源包或仅引擎配置，详见测试报告

欢迎补充游戏库

本工具支持任意明文文本格式的游戏/模组。如果你的游戏文案以明文文件（.json / .tsv / .lang / .sii / .vdf 等）存储，欢迎通过 Issue / PR 补充游戏库，一起扩展现有解析器。

已完成的支持范围见 [SUPPORTED_GAMES.md](SUPPORTED_GAMES.md)
详细测试与新增游戏接入指引见 tests/reports/
新格式接入步骤见下方「贡献指南」

与现有工具链的关系

工具	协作方式
`mc-translator-mcp`	Minecraft 专用强化版；本工具的 MC 子集
`mc-pack-builder-mcp`	构建整合包时自动检测模组是否需要汉化，并调用本工具完成翻译
`mc-mod-config-mcp`	汉化完成后检查配置文件格式是否正常
LangChain Agent	通过 MCP stdio 协议接入，支持自然语言驱动汉化流程

贡献指南

添加对新游戏格式的支持：

在 parser.py 中添加新的解析函数（如 _parse_locres）
注册到 _PARSERS 字典
在 scanner.py 的 SUPPORTED_EXTENSIONS 中添加扩展名
在 tests/test_parser.py 中添加对应测试

许可证

MIT License — 自由使用、修改和分发。

Game Translator

What it does

Instalación

Instala uv (si no lo tienes)

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala uv (si no lo tienes)

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir Cursor

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir VS Code

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Vulnerabilidades publicadas (OSV.dev)

Conversación

Reseñas de usuarios

Comparado con otros en Juegos, deportes, comida y aprendizajei

Preguntas frecuentes

Alternativas parecidas

Anime Garden

WilmAI

Lumify Sports Intelligence

Savecraft

GoodWatch

README del creador

game-translator-mcp

适用范围

使用条件

安装

配置

方式 B：agnes ai（也可展开为 OpenAi 兼容平台）

AGNES_API_KEY=sk-xxx

AGNES_BASE_URL=https://apihub.agnes-ai.com/v1

AGNES_MODEL=agnes-2.5-flash

方式 C：通义千问

DASHSCOPE_API_KEY=sk-your-qwen-key-here

方式 D：DeepSeek（可选，主供应商失败时 fallback）

DEEPSEEK_API_KEY=

启动方式

作为 MCP 服务器（供 AI Agent 调用）

CLI 模式

若游戏的明文配置文件超过 10MB 被跳过，可用 --max-size-mb 调高阈值再扫

扫描游戏目录，列出可翻译文件

执行完整汉化

预览翻译效果（抽样翻译，不写入文件）

列出 Steam 库中的可翻译游戏

MCP 工具

使用示例

自然语言调用（通过 Trae）

直接命令行调用

输出目录默认为 translated_output/

汉化报告自动生成到 translated_output/report.txt

新手怎么用（一句话版）

怎么把汉化「装」进游戏（导入 / 覆盖原文件教学）

输出结构

核心模块

设计要点

测试

或

真实汉化测试