Servidor MCP de DeepL

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona capacidades de traducción de alta calidad a través de la API de DeepL.

Características

Este servidor proporciona 24 herramientas para trabajar con DeepL:

Características de traducción

• Selección de modelo de próxima generación — Usa valores de model_type como quality_optimized o prefer_quality_optimized

• Control de formalidad — Ajusta el tono para contextos formales/informales

• Parámetro de contexto — Proporciona contexto adicional para una mayor precisión (no se factura)

• Soporte de glosario — Crea, lista, inspecciona, usa y elimina glosarios v3 de DeepL

• Traducción por lotes — Traduce múltiples textos en una sola solicitud

• Preservar formato — Mantén el formato del texto original

• Manejo de etiquetas HTML/XML — Usa tag_handling, tag_handling_version, ignore_tags, splitting_tags y opciones relacionadas

• Visibilidad de facturación — Usa show_billed_characters para incluir el recuento de caracteres facturados en las respuestas de traducción

• Traducción de documentos — Sube, consulta y descarga archivos traducidos

• Metadatos de idioma v3 — Recupera el soporte de idiomas específico del producto y las reglas de características

• Memorias de traducción — Lista las memorias de traducción de la cuenta y úsalas en las solicitudes de traducción

• Reglas de estilo — Lista, crea, inspecciona, renombra, elimina y usa listas de reglas de estilo

• Configuración de sesión de voz — Solicita o reconecta sesiones WebSocket en tiempo real de DeepL Voice; la transmisión de audio se realiza mediante la URL de WebSocket devuelta

• Opciones de DeepL Write — Parafrasea con writing_style y tone cuando el plan admite la API de Write

• Control de división de oraciones — Controla cómo se dividen las oraciones

Detección automática del tipo de API

El servidor detecta automáticamente si estás usando la API gratuita o Pro según el formato de tu clave:

• Claves que terminan en :fx → API gratuita (api-free.deepl.com)

• Otras claves → API Pro (api.deepl.com)

Related MCP server: GeoServer MCP Server

Requisitos previos

• Node.js 18+ (incluyendo Node.js 25)

• Clave de API de DeepL — Regístrate aquí (Nivel gratuito disponible)

Inicio rápido

1. Clonar y compilar

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

2. Configurar tu cliente MCP

Añade a la configuración de tu cliente MCP:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "deepl": {
      "command": "node",
      "args": ["/path/to/deepl-mcp-server/build/index.js"],
      "env": {
        "DEEPL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code (.mcp.json en tu proyecto):

{
  "mcpServers": {
    "deepl": {
      "command": "node",
      "args": ["/path/to/deepl-mcp-server/build/index.js"],
      "env": {
        "DEEPL_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Reiniciar tu cliente MCP

Reinicia Claude Desktop o Claude Code para cargar el servidor.

Ejemplos de uso

Traducción básica

{
  "text": "Hello, how are you?",
  "target_lang": "DE"
}

Traducción formal con contexto

{
  "text": "Thanks for your help!",
  "target_lang": "DE",
  "formality": "more",
  "context": "Business email to a client"
}

Traducción por lotes

{
  "text": ["Hello", "Goodbye", "Thank you"],
  "target_lang": "FR"
}

Comprobar el uso de la API

Usa get_usage para ver tu cuota actual:

{
  "character_count": 12500,
  "character_limit": 500000,
  "characters_remaining": 487500,
  "percent_used": "2.50%",
  "api_type": "Free"
}

Idiomas admitidos

Idiomas de origen (detectados automáticamente si se omiten)

AR, BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH

Idiomas de destino

Todos los idiomas de origen más variantes regionales:

• EN-GB — Inglés británico

• EN-US — Inglés estadounidense

• PT-BR — Portugués brasileño

• PT-PT — Portugués europeo

• ZH-HANS — Chino simplificado

• ZH-HANT — Chino tradicional

Usa get_target_languages para obtener una lista completa con indicadores de soporte de formalidad.

Manejo de errores

El servidor maneja los errores comunes de la API:

• 400 — Parámetros no válidos

• 401/403 — Autenticación fallida o característica no disponible en el plan actual

• 429 — Límite de tasa excedido

• 456 — Cuota excedida

Seguridad y estado de OSV

Este repositorio ha sido escaneado con el OSV-Scanner de Google y remediado a un estado limpio.

• Resultado del último escaneo: 0 vulnerabilidades de dependencia conocidas

• Los informes se escriben en .osv/osv-report.json y .osv/osv-summary.md

• Las notas de remediación están en .osv/remediation-notes.md

• Las cadenas de dependencia directa vulnerables se corrigieron actualizando @modelcontextprotocol/sdk y axios

Ejecuta el escaneo localmente:

export PATH="$HOME/.local/bin:$PATH"
osv-project-scan .

Desarrollo

# Watch mode (auto-rebuild)
npm run watch

# Manual build
npm run build

# Run the server
npm start

# Test with MCP Inspector
npm run inspector

# Run live end-to-end tests against DeepL API
# Requires DEEPL_API_KEY in the environment and consumes a small number of billable characters.
npm run test:live

La prueba en vivo ejercita la traducción, el listado de idiomas, los metadatos de idioma v3, el listado de memorias de traducción, el listado/creación/obtención/actualización/eliminación de reglas de estilo cuando están disponibles, la solicitud de sesión de voz cuando está disponible, el uso, la creación/uso/eliminación de glosarios, la carga/estado/descarga de documentos y DeepL Write. Las claves de API gratuitas pueden devolver un error de plan esperado para DeepL Write.

Licencia

Licencia MIT — consulta el archivo LICENSE.

Enlaces

• Documentación de la API de DeepL

• DeepL Pro API — Regístrate para obtener acceso a la API

• Protocolo de Contexto de Modelo — Documentación de MCP