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).

Related MCP server: GeoServer MCP Server

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

1. Clonar el repositorio:

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

2. Instalar dependencias:

   npm install
   # or
   # yarn install

3. 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

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

1. 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).)

2. 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

1. 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).

2. 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.