DeepL

Traduza texto usando a API DeepL.

Documentação

servidor-mcp-deepl

[!NOTE] Para a melhor experiência e os recursos mais recentes, confira o servidor MCP remoto do DeepL para usar o DeepL no seu agente de IA. Não é necessária instalação; basta adicioná-lo ao Claude, ChatGPT, Microsoft Copilot ou qualquer cliente MCP e entrar com sua conta do DeepL.

Trabalhando em um terminal ou com um agente de codificação? Experimente o CLI do DeepL. Ele cobre tradução, documentos, glossários e sincronização de arquivos i18n com sua chave de API.

Um servidor Model Context Protocol (MCP) que expõe tradução de texto do DeepL, tradução de documentos, reformulação e consultas de glossário e regras de estilo como ferramentas MCP.

Uso

Você precisa do Node.js 18 ou mais recente e de uma chave de API do DeepL. Escolha um plano de API e crie uma chave na sua conta do DeepL.

O servidor se comunica via stdio, então normalmente é iniciado por um cliente MCP em vez de manualmente. Para testá-lo diretamente:

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

Ele sai imediatamente se DEEPL_API_KEY não estiver definido.

Para trabalhar no próprio servidor:

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

Configuração

Registre-o como um servidor stdio com DEEPL_API_KEY no ambiente do servidor. No Claude Code:

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

Para clientes configurados por meio de um arquivo JSON:

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

Onde esse arquivo fica e como cada cliente espera que servidores stdio locais sejam declarados:

Para executar um checkout local em vez do pacote publicado, use node como comando e o caminho absoluto para src/index.mjs como argumento.

Ferramentas

Ferramenta	Descrição	Parâmetros
`translate-text`	Traduz texto para um idioma de destino.	`text`, `targetLangCode`, `sourceLangCode?`, `formality?`, `glossaryId?`, `styleId?`, `context?`, `preserveFormatting?`, `splitSentences?`, `customInstructions?`
`translate-document`	Traduz um arquivo de documento (PDF, DOCX, PPTX, XLSX, HTML, TXT e outros) e grava o resultado no disco.	`inputFile`, `targetLangCode`, `outputFile?`, `sourceLangCode?`, `formality?`, `glossaryId?`, `styleId?`, `outputFormat?`
`rephrase-text`	Reformula texto, opcionalmente para outro idioma.	`text`, `targetLangCode?`, `style?`, `tone?`
`get-source-languages`	Lista os códigos de idioma aceitos como fonte de tradução.	nenhum
`get-target-languages`	Lista os códigos de idioma aceitos como destino de tradução.	nenhum
`get-writing-styles`	Lista os valores de `style` que `rephrase-text` aceita.	nenhum
`get-writing-tones`	Lista os valores de `tone` que `rephrase-text` aceita.	nenhum
`list-glossaries`	Lista todos os glossários na conta com id, nome, dicionários e horário de criação.	nenhum
`get-glossary-info`	Retorna os mesmos metadados que `list-glossaries` para um único glossário.	`glossaryId`
`get-glossary-dictionary-entries`	Retorna as entradas de termos de um dicionário de glossário, ou seja, um par de idiomas em uma direção.	`glossaryId`, `sourceLangCode`, `targetLangCode`
`list-style-rules`	Lista as regras de estilo na conta com id, nome, idioma e carimbos de data/hora.	`page?`, `pageSize?`, `detailed?`
`get-style-rule`	Retorna uma regra de estilo completa, incluindo suas regras configuradas e instruções personalizadas.	`styleId`
`get-custom-instruction`	Retorna uma única instrução personalizada pertencente a uma regra de estilo.	`styleId`, `instructionId`

Observações:

text aceita uma única string ou um array de strings. Cada entrada é traduzida ou reformulada de forma independente.
Os códigos de idioma são ISO 639-1, opcionalmente com uma região (en-US). Omitir sourceLangCode aciona a detecção automática. Um código de destino cujo idioma exige uma região recebe um padrão aplicado: en torna-se en-US, pt torna-se pt-BR, zh torna-se zh-Hans.
Os dicionários de glossário são identificados por códigos não regionais, então get-glossary-dictionary-entries remove qualquer região que você passar.
Traduzir com um glossário exige um sourceLangCode explícito.
formality aceita less, more, default, prefer_less e prefer_more. Os valores de prefer_* voltam ao padrão quando o idioma de destino não tem suporte a formalidade.
translate-document lê e grava arquivos na máquina que executa o servidor. Sem outputFile, o caminho de saída é derivado da entrada anexando o código do idioma de destino, por exemplo report_de.pdf. Com outputFormat, o caminho derivado usa essa extensão em vez disso.
Regras de estilo e instruções personalizadas são somente leitura aqui. Crie e edite-as na sua conta do DeepL.

Licença

MIT