Servidor MCP de DeepL

Un servidor MCP (Protocolo de contexto de modelo) que proporciona capacidades de traducción DeepL.

Características

Este servidor expone las siguientes herramientas a través de MCP:

translate_text : traduce una o más cadenas de texto entre los idiomas admitidos mediante la API de DeepL.
list_languages : recupera la lista de idiomas admitidos por la API de DeepL (idiomas de origen o de destino).

Prerrequisitos

Node.js y npm/yarn: necesarios para instalar dependencias y ejecutar el servidor.
Clave API de DeepL: Necesita una clave API de DeepL. Tanto el plan gratuito como el Pro ofrecen acceso a la API. Regístrese o obtenga más información en https://www.deepl.com/pro-api .

Instalación

Clonar el repositorio:
git clone https://github.com/watchdealer-pavel/deepl-mcp-server.git cd deepl-mcp-server
Instalar dependencias:
npm install # or # yarn install
Construir el servidor:
npm run build
Este comando compila el código fuente de TypeScript en JavaScript, colocando la salida en el directorio build/ (específicamente build/index.js ).

Configuración

El servidor requiere que proporciones tu clave API de DeepL mediante la variable de entorno DEEPL_API_KEY . Debes configurar tu cliente MCP (como Cline/Roo Code o la aplicación de escritorio Claude) para ejecutar este servidor y pasar la variable de entorno.

Ejemplo de configuración:

A continuación se muestran ejemplos de clientes MCP comunes. Recuerde reemplazar /path/to/your/deepl-mcp-server/build/index.js to/your/deepl-mcp-server/build/index.js` con la ruta absoluta real al archivo del servidor compilado en su sistema, y YOUR_DEEPL_API_KEY con su clave API de DeepL real.

Código Cline/Roo (Extensión VS Code)

Abra la configuración de VS Code para servidores MCP. En macOS, normalmente se encuentra en: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json(Nota: La ruta exacta puede variar según el sistema operativo y el tipo de instalación de VS Code (p. ej., Insiders).)
Agregue el siguiente bloque de configuración bajo la clave mcpServers :
"deepl-translator": { "command": "node", "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- IMPORTANT: Replace with your DeepL API Key }, "disabled": false, "alwaysAllow": [] }

Aplicación de escritorio Claude

Abra el archivo de configuración de la aplicación Claude Desktop. En macOS, suele estar en: ~/Library/Application Support/Claude/claude_desktop_config.json(Nota: La ruta exacta puede variar según el sistema operativo).
Agregue el siguiente bloque de configuración bajo la clave mcpServers :
"deepl-translator": { "command": "node", "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- IMPORTANT: Replace with your DeepL API Key }, "disabled": false, "alwaysAllow": [] }

Uso

Una vez configurado, puedes invocar las herramientas del servidor desde tu asistente de IA usando el comando/herramienta use_mcp_tool .

Ejemplo `list_languages`

<use_mcp_tool>
  <server_name>deepl-translator</server_name>
  <tool_name>list_languages</tool_name>
  <arguments>
    {
      "type": "target" // Optional: "source" or "target". Defaults to listing all if omitted.
    }
  </arguments>
</use_mcp_tool>

Ejemplo `translate_text`

<use_mcp_tool>
  <server_name>deepl-translator</server_name>
  <tool_name>translate_text</tool_name>
  <arguments>
    {
      "text": ["Hello world", "How are you?"], // Required: An array of strings to translate
      "target_lang": "DE", // Required: Target language code (e.g., DE, FR, ES)
      "source_lang": "EN" // Optional: Source language code. DeepL will auto-detect if omitted.
    }
  </arguments>
</use_mcp_tool>

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.