DeepL

Traduce texto usando la API de DeepL.

Documentación

deepl-mcp-server

[!NOTE] Para una mejor experiencia y las funciones más recientes, consulta el servidor MCP remoto de DeepL para usar DeepL en tu agente de IA. No requiere instalación; solo agrégalo a Claude, ChatGPT, Microsoft Copilot o cualquier cliente MCP e inicia sesión con tu cuenta de DeepL.

¿Trabajas en una terminal o con un agente de codificación? Prueba la CLI de DeepL. Cubre traducción, documentos, glosarios y sincronización de archivos i18n con tu clave de API.

Un servidor de Model Context Protocol (MCP) que expone la traducción de texto de DeepL, la traducción de documentos, la reformulación y las consultas de glosarios y reglas de estilo como herramientas MCP.

Uso

Necesitas Node.js 18 o superior y una clave de API de DeepL. Elige un plan de API y crea una clave en tu cuenta de DeepL.

El servidor se comunica a través de stdio, por lo que normalmente lo inicia un cliente MCP en lugar de ejecutarse manualmente. Para probarlo directamente:

DEEPL_API_KEY=your-api-key npx -y deepl-mcp-server

Se cierra inmediatamente si DEEPL_API_KEY no está configurado.

Para trabajar en el propio servidor:

git clone https://github.com/DeepL/deepl-mcp-server.git
cd deepl-mcp-server
npm install

Configuración

Regístralo como un servidor stdio con DEEPL_API_KEY en el entorno del servidor. En Claude Code:

claude mcp add deepl --env DEEPL_API_KEY=your-api-key -- npx -y deepl-mcp-server

Para clientes configurados mediante un archivo JSON:

{
  "mcpServers": {
    "deepl": {
      "command": "npx",
      "args": ["-y", "deepl-mcp-server"],
      "env": {
        "DEEPL_API_KEY": "your-api-key"
      }
    }
  }
}

Dónde se encuentra ese archivo y cómo espera cada cliente que se declaren los servidores stdio locales:

Para ejecutar una copia local en lugar del paquete publicado, usa node como comando y la ruta absoluta a src/index.mjs como argumento.

Herramientas

Herramienta	Descripción	Parámetros
`translate-text`	Traduce texto a un idioma de destino.	`text`, `targetLangCode`, `sourceLangCode?`, `formality?`, `glossaryId?`, `styleId?`, `context?`, `preserveFormatting?`, `splitSentences?`, `customInstructions?`
`translate-document`	Traduce un archivo de documento (PDF, DOCX, PPTX, XLSX, HTML, TXT y más) y escribe el resultado en el disco.	`inputFile`, `targetLangCode`, `outputFile?`, `sourceLangCode?`, `formality?`, `glossaryId?`, `styleId?`, `outputFormat?`
`rephrase-text`	Reformula texto, opcionalmente a otro idioma.	`text`, `targetLangCode?`, `style?`, `tone?`
`get-source-languages`	Lista los códigos de idioma aceptados como fuente de traducción.	ninguno
`get-target-languages`	Lista los códigos de idioma aceptados como destino de traducción.	ninguno
`get-writing-styles`	Lista los valores de `style` que acepta `rephrase-text`.	ninguno
`get-writing-tones`	Lista los valores de `tone` que acepta `rephrase-text`.	ninguno
`list-glossaries`	Lista todos los glosarios de la cuenta con su id, nombre, diccionarios y hora de creación.	ninguno
`get-glossary-info`	Devuelve los mismos metadatos que `list-glossaries` para un solo glosario.	`glossaryId`
`get-glossary-dictionary-entries`	Devuelve las entradas de términos de un diccionario de glosario, es decir, un par de idiomas en una dirección.	`glossaryId`, `sourceLangCode`, `targetLangCode`
`list-style-rules`	Lista las reglas de estilo de la cuenta con su id, nombre, idioma y marcas de tiempo.	`page?`, `pageSize?`, `detailed?`
`get-style-rule`	Devuelve una regla de estilo completa, incluidas sus reglas configuradas e instrucciones personalizadas.	`styleId`
`get-custom-instruction`	Devuelve una instrucción personalizada individual perteneciente a una regla de estilo.	`styleId`, `instructionId`

Notas:

text acepta una sola cadena o un arreglo de cadenas. Cada entrada se traduce o reformula de forma independiente.
Los códigos de idioma son ISO 639-1, opcionalmente con una región (en-US). Omitir sourceLangCode activa la detección automática. Un código de destino cuyo idioma requiere una región recibe un valor predeterminado: en se convierte en en-US, pt se convierte en pt-BR, zh se convierte en zh-Hans.
Los diccionarios de glosarios se identifican por códigos no regionales, por lo que get-glossary-dictionary-entries elimina cualquier región que pases.
Traducir con un glosario requiere un sourceLangCode explícito.
formality acepta less, more, default, prefer_less y prefer_more. Los valores de prefer_* recurren al valor predeterminado cuando el idioma de destino no admite formalidad.
translate-document lee y escribe archivos en la máquina que ejecuta el servidor. Sin outputFile, la ruta de salida se deriva de la entrada añadiendo el código del idioma de destino, por ejemplo report_de.pdf. Con outputFormat, la ruta derivada usa esa extensión en su lugar.
Las reglas de estilo y las instrucciones personalizadas son de solo lectura aquí. Créalas y edítalas en tu cuenta de DeepL.

Licencia

MIT