MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Local NLLB translation for 200+ languages. Zero cloud, zero cost, runs entirely on your machine.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 3/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 3/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala MCP Local Translate. Sigue https://mcp.popnx.com/i/damoqiongqiu-mcp-local-translate.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js 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
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 MCP Local Translate para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "local-translate": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 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 MCP Local Translate 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.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}Usa MCP Local Translate y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando MCP Local Translate o muestra una herramienta de MCP Local Translate en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HF_ENDPOINT Reemplazo del endpoint de HuggingFace para descargar modelos (p. ej., https://hf-mirror.com para China). HF_AUTO_MIRROR Detecta automáticamente el espejo de HuggingFace para China. Establézcalo en '0' o 'false' para desactivarlo. CACHE_DIR Directorio donde se almacenan en caché los modelos de Transformers.js (predeterminado ./models/) TRANSLATE_DEVICE Dispositivo de ejecución: 'cpu' (predeterminado) o 'webgpu' para aceleración por GPU. HTTPS_PROXY URL del proxy para las descargas de modelos. También admite HTTP_PROXY y variantes en minúsculas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
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 MCP Local Translate
MCP Local Translate se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar MCP Local Translate
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
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 MCP Local Translate para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translate 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 MCP Local Translate 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.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translateDeberías ver MCP Local Translate en la lista como conectado
Usa MCP Local Translate y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando MCP Local Translate o muestra una herramienta de MCP Local Translate en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HF_ENDPOINT Reemplazo del endpoint de HuggingFace para descargar modelos (p. ej., https://hf-mirror.com para China). HF_AUTO_MIRROR Detecta automáticamente el espejo de HuggingFace para China. Establézcalo en '0' o 'false' para desactivarlo. CACHE_DIR Directorio donde se almacenan en caché los modelos de Transformers.js (predeterminado ./models/) TRANSLATE_DEVICE Dispositivo de ejecución: 'cpu' (predeterminado) o 'webgpu' para aceleración por GPU. HTTPS_PROXY URL del proxy para las descargas de modelos. También admite HTTP_PROXY y variantes en minúsculas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
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 Node.js en tu computadora primero (una sola vez)
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 MCP Local Translate para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "local-translate": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 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 MCP Local Translate 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.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa MCP Local Translate y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando MCP Local Translate o muestra una herramienta de MCP Local Translate en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HF_ENDPOINT Reemplazo del endpoint de HuggingFace para descargar modelos (p. ej., https://hf-mirror.com para China). HF_AUTO_MIRROR Detecta automáticamente el espejo de HuggingFace para China. Establézcalo en '0' o 'false' para desactivarlo. CACHE_DIR Directorio donde se almacenan en caché los modelos de Transformers.js (predeterminado ./models/) TRANSLATE_DEVICE Dispositivo de ejecución: 'cpu' (predeterminado) o 'webgpu' para aceleración por GPU. HTTPS_PROXY URL del proxy para las descargas de modelos. También admite HTTP_PROXY y variantes en minúsculas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
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 Node.js en tu computadora primero (una sola vez)
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 MCP Local Translate para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "local-translate": { "type": "stdio", "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 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 MCP Local Translate 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.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa MCP Local Translate y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando MCP Local Translate o muestra una herramienta de MCP Local Translate en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HF_ENDPOINT Reemplazo del endpoint de HuggingFace para descargar modelos (p. ej., https://hf-mirror.com para China). HF_AUTO_MIRROR Detecta automáticamente el espejo de HuggingFace para China. Establézcalo en '0' o 'false' para desactivarlo. CACHE_DIR Directorio donde se almacenan en caché los modelos de Transformers.js (predeterminado ./models/) TRANSLATE_DEVICE Dispositivo de ejecución: 'cpu' (predeterminado) o 'webgpu' para aceleración por GPU. HTTPS_PROXY URL del proxy para las descargas de modelos. También admite HTTP_PROXY y variantes en minúsculas. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
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
Claude Code
claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translateClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"local-translate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}HF_ENDPOINT envHF_AUTO_MIRROR envCACHE_DIR envTRANSLATE_DEVICE envHTTPS_PROXY envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
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
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub damoqiongqiu, dueña del repo
Último cambio de código: hace 4 meses
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para @damoqiongqiu/mcp-local-translate@0.1.11
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/damoqiongqiu-mcp-local-translate)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.
Aún no hay reseñas
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.
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.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
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).
El repo de GitHub cambió por última vez hace 4 meses, y la última versión (0.1.11) llegó al registro hace 4 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
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
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este MCP Local Translate | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
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.
🍴 Inspired by shinpr/mcp-local-rag — original architecture patterns by Shinsuke Kagawa
AI 编程助手的本地翻译引擎。基于 NLLB-200 模型,支持 200+ 语言互译——完全离线,数据不离开你的机器。为多语言开发、文档阅读、代码注释翻译而生。
📖 English
zho_Hans)、ISO 639-1 简码(zh)、语言名称(Chinese)、中文别名(中文)——自动映射到正确的模型输入。npx 命令搞定。无需 Docker、Python、GPU。可通过 MCP 或 CLI 使用。Cursor — 添加到 ~/.cursor/mcp.json:
{
"mcpServers": { "local-translate": { "command": "npx", "args": ["-y", "@damoqiongqiu/mcp-local-translate"], "env": { "CACHE_DIR": "/path/to/models" } } } }
Codex — 添加到 ~/.codex/config.toml:
[mcp_servers.local-translate]
command = "npx" args = ["-y", "@damoqiongqiu/mcp-local-translate"]
[mcp_servers.local-translate.env] CACHE_DIR = "/path/to/models"
Claude Code — 运行以下命令:
claude mcp add local-translate --scope user --env CACHE_DIR=/path/to/models -- npx -y @damoqiongqiu/mcp-local-translate
WorkBuddy — 打开「设置 → 自定义连接器 → 添加自定义连接器」:
{
"mcpServers": { "local-translate": { "command": "npx", "args": ["-y", "@damoqiongqiu/mcp-local-translate"], "env": { "CACHE_DIR": "/path/to/models" } } } }
⚠️ 首次添加后,必须在「自定义连接器」列表中点击「信任」按钮,否则 MCP 服务器不会启动。这是 WorkBuddy 的安全机制——未经信任的自定义连接器会被静默阻止。
重启工具后即可使用:
你: "把这段文档翻译成中文"
助手: [返回翻译结果]
你: "This error message is in Japanese — what does it say?" 助手: 那是「データベース接続に失敗しました」—— 数据库连接失败。
你: "列出所有支持的翻译语言" 助手: 共 204 种语言,包括 中文、英语、日语、法语...
也可直接作为 CLI 使用——无需启动 MCP 服务器:
npx @damoqiongqiu/mcp-local-translate translate "Hello, world!" --source en --target zh
npx @damoqiongqiu/mcp-local-translate list-languages --query "chinese"
就这些。无需 Docker,无需 Python,无需配置服务器。
你的 AI 编程助手可以帮你写代码,但当你面对非母语的文档、注释、错误日志时,仍然需要跳出编程环境去复制粘贴到在线翻译工具。
隐私。 把代码片段或内部文档粘贴到 Google Translate 本质上是数据泄露。这个工具完全在本地运行——没有人能看到你的文本。
离线可用。 配置完成后无需联网即可使用——飞机上、咖啡店无 WiFi、空气间隙环境。
低资源语言。 NLLB-200 覆盖了 Google Translate 和 DeepL 不支持的小语言(如藏语、维吾尔语、高棉语等)。
成本。 无需为翻译 API 付费。只需一次模型下载(~600MB),然后无限使用。
mcp-local-translate 提供两种接口:MCP 服务器(供 AI 编程工具使用)和 CLI(供终端直接使用)。
MCP 服务器提供 2 个工具:translate 和 list_languages。
"把这段 React hooks 文档翻译成中文"
"Translate the error message to English" "这段日语注释是什么意思?"
translate 工具接受:
| 参数 | 类型 | 说明 |
|---|---|---|
text | string | 待翻译文本 |
source_lang | string | 源语言代码(auto 自动检测) |
target_lang | string | 目标语言代码 |
语言代码支持三种格式:
zho_Hans(简体中文)、eng_Latn(英语)、jpn_Jpan(日语)zh、en、ja、fr、de中文、英语、日语、韩语"这个翻译引擎支持多少种语言?"
"看看有没有藏语"
使用 list_languages 工具,可选 query 参数进行关键词过滤。
所有 MCP 工具也可以通过 CLI 命令使用——无需启动 MCP 服务器:
# 翻译文本
npx @damoqiongqiu/mcp-local-translate translate "Hello, world!" --source en --target zh
npx @damoqiongqiu/mcp-local-translate translate "Bonjour le monde" --source auto --target en
npx @damoqiongqiu/mcp-local-translate list-languages
npx @damoqiongqiu/mcp-local-translate list-languages --query "chinese"
⚠️ CLI 不会读取你的 MCP 客户端配置(
mcp.json、config.toml等)。通过命令行标志或环境变量配置 CLI,如下所示。
简要:
当你调用 translate 时:
zho_Hans),再查 ISO 639-1 别名表(zh → zho_Hans),最后查中文别名表(中文 → zho_Hans)。如果全部失败,进行模糊搜索并给出建议。/(?<=[.!?。!?\n])\s+/),确保不截断到句子中间。每块加上源语言和目标语言标记。Xenova/nllb-200-distilled-600M)翻译。模型通过懒加载初始化——首次翻译时下载并加载到内存,后续调用复用同一管道。MCP 服务器仅通过环境变量配置——通过 MCP 客户端的 env 块传入。
| 环境变量 | 默认值 | 描述 |
|---|---|---|
CACHE_DIR | 系统默认 | 模型缓存目录。NLLB-200 模型(~600MB)自动下载到此。建议使用绝对路径。 |
HF_ENDPOINT | https://huggingface.co | HuggingFace 镜像端点。设置后跳过自动镜像检测。 |
HF_AUTO_MIRROR | true | 自动镜像检测开关。设为 false 禁用。默认开启,首次下载前自动探测三级镜像链:huggingface.co → hf-mirror.com → modelscope.cn。 |
HTTPS_PROXY | (未设置) | HTTP 代理地址,用于下载模型(如 http://127.0.0.1:7890)。通过 setGlobalDispatcher 全局生效。 |
TRANSLATE_DEVICE | cpu | 推理设备。直接传给 Transformers.js。目前仅推荐 cpu。 |
性能
在 MacBook Pro M1(16GB RAM)、Node.js 22 上测试:
首次启动:
翻译速度:
内存:空闲 ~300MB,翻译峰值 ~1.2GB
故障排查
症状:启动日志中出现 fetch failed 或模型加载超时。
原因与排查:
huggingface.co 会超时。首选方案:不用配置 — mcp-local-translate 默认自动探测三级镜像链:huggingface.co → hf-mirror.com → modelscope.cn,逐级回退直到找到可用镜像。
备选方案:配置代理:
"env": {
"HTTPS_PROXY": "http://127.0.0.1:7890" }
手动指定镜像:
"env": {
"HF_ENDPOINT": "https://hf-mirror.com" }
CACHE_DIR 目录存在且包含 Xenova/nllb-200-distilled-600M/ 子目录。如果之前用不同的 CACHE_DIR 下载过模型,更新路径指向已有缓存即可避免重复下载。 rm -rf ~/.npm/_npx/
运行 list_languages 查看所有支持的语言及其代码。语言代码是 FLORES-200 格式(如 zho_Hans、eng_Latn),也可以使用 ISO 639-1 简码(如 zh、en)或中文别名(如 中文、英语)。
NLLB-200 在 CPU 上运行,翻译速度取决于你的硬件。长文本会被自动分块处理,每块约 2-3 秒。
常见问题
这真的私密吗? 是的。在模型下载之后,没有任何数据离开你的机器。可用网络监控验证。
可以离线使用吗? 可以,只要 NLLB-200 模型已缓存到本地。
与 Google Translate / DeepL 相比如何? 云端服务翻译质量更高(更大模型、更多训练数据),但需要将数据发送到外部。这个工具用一些质量换取完全隐私和零成本。
支持哪些语言? NLLB-200 支持 200+ 种语言。运行 list_languages 查看完整列表。
支持方言吗? NLLB-200 覆盖部分方言变体(如巴西葡萄牙语 por_Latn、拉美西班牙语等),但不像主流语言那样广泛。具体取决于模型训练数据。
翻译质量怎么样? 对主流语言对(英↔中、英↔法、英↔西等),600M 蒸馏模型提供不错的翻译质量。对低资源语言,质量会下降——可读但不保证优雅。
多用户支持? 不支持。专为单用户本地访问设计。
开发
git clone https://github.com/damoqiongqiu/mcp-local-translate.git
cd mcp-local-translate pnpm install
pnpm run type-check # TypeScript 检查
pnpm run check:fix # Lint 和格式化 pnpm run build # 编译
src/
index.ts # 入口点 — 路由到 CLI 或 MCP 服务器 server-main.ts # MCP 服务器启动 server/ index.ts # MCP 工具处理器(translate、list_languages) types.ts # MCP 工具定义 translator/ index.ts # 核心翻译引擎(NLLB-200 管道、分块、懒加载) connectivity.ts # 镜像检测与代理配置 language-codes.ts # FLORES-200 语言代码与解析器 utils/ # 共享工具 skills/ # 随包发布的 Agent Skills
Agent Skills 提供优化的提示词,帮助 AI 助手更有效地使用翻译工具:
# Claude Code(项目级别)
npx @damoqiongqiu/mcp-local-translate skills install --claude-code
npx @damoqiongqiu/mcp-local-translate skills install --claude-code --global
npx @damoqiongqiu/mcp-local-translate skills install --codex
Skills 包括:
欢迎贡献!参见 CONTRIBUTING.md 了解环境搭建和指南。
MIT License。免费用于个人和商业用途。
架构模式参考 mcp-local-rag by Shinsuke Kagawa。使用 Model Context Protocol by Anthropic 和 Transformers.js 构建。翻译模型:NLLB-200 by Meta AI。