deepl-mcp-server

deepl-mcp-server

说明

如需获得最佳体验并使用最新功能，请试试 DeepL 远程 MCP 服务，在 AI Agent 中使用 DeepL。无需安装，只需将其添加到 Claude、ChatGPT、Microsoft Copilot 或任何 MCP 客户端，然后使用 DeepL 账号登录。

在终端中工作或使用编码 Agent？试试 DeepL CLI。它支持翻译、文档、术语表和 i18n 文件同步，并使用你的 API 密钥。

一个 Model Context Protocol（MCP）服务，将 DeepL 文本翻译、文档翻译、改写以及术语表和风格规则查询作为 MCP 工具提供。

使用方法

你需要 Node.js 18 或更高版本，以及 DeepL API 密钥。选择一个 API 计划，并在 DeepL 账号中创建密钥。

该服务通过 stdio 通信，因此通常由 MCP 客户端启动，而不是手动启动。要直接试用：

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

如果未设置 DEEPL_API_KEY，它会立即退出。

要开发该服务本身：

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

配置

将其注册为 stdio 服务，并在服务环境中设置 DEEPL_API_KEY。在 Claude Code 中：

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

对于通过 JSON 文件配置的客户端：

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

以下是各文件所在位置，以及各客户端声明本地 stdio 服务的方式：

• Claude Code
• Claude Desktop
• Cursor
• VS Code

如需运行本地检出版本，而非已发布的软件包，请将 node 用作命令，并将 src/index.mjs 的绝对路径用作参数。

工具

工具	描述	参数
translate-text	将文本翻译成目标语言。	text、targetLangCode、sourceLangCode?、formality?、glossaryId?、styleId?、context?、preserveFormatting?、splitSentences?、customInstructions?
translate-document	翻译文档文件（PDF、DOCX、PPTX、XLSX、HTML、TXT 等），并将结果写入磁盘。	inputFile、targetLangCode、outputFile?、sourceLangCode?、formality?、glossaryId?、styleId?、outputFormat?
rephrase-text	改写文本，也可选择将其改写为另一种语言。	text、targetLangCode?、style?、tone?
get-source-languages	列出可接受的源语言代码。	无
get-target-languages	列出可接受的目标语言代码。	无
get-writing-styles	列出 rephrase-text 接受的 style 值。	无
get-writing-tones	列出 rephrase-text 接受的 tone 值。	无
list-glossaries	列出账户中的所有术语表及其 ID、名称、词典和创建时间。	无
get-glossary-info	返回单个术语表与 list-glossaries 相同的元数据。	glossaryId
get-glossary-dictionary-entries	返回一个术语表词典中的术语条目，即一个方向上的一组语言对。	glossaryId、sourceLangCode、targetLangCode
list-style-rules	列出账户中的风格规则及其 ID、名称、语言和时间戳。	page?、pageSize?、detailed?
get-style-rule	完整返回一条风格规则，包括其配置的规则和自定义指令。	styleId
get-custom-instruction	返回一条属于风格规则的自定义指令。	styleId、instructionId
注意：

• text 接受单个字符串或字符串数组。每个条目都会单独翻译或改写。
• 语言代码遵循 ISO 639-1，可选择带上地区代码（en-US）。省略 sourceLangCode 会触发自动检测。目标语言代码对应的语言需要地区代码时，会自动应用默认值：en 变为 en-US，pt 变为 pt-BR，zh 变为 zh-Hans。
• 术语表字典使用不带地区代码的语言代码作为键，因此 get-glossary-dictionary-entries 会去掉你传入的任何地区代码。
• 使用术语表翻译时，必须明确指定 sourceLangCode。
• formality 接受 less、more、default、prefer_less 和 prefer_more。目标语言不支持正式程度选项时，prefer_* 值会回退到默认值。
• translate-document 会读取和写入运行服务的计算机上的文件。未指定 outputFile 时，输出路径会在输入文件路径的基础上追加目标语言代码，例如 report_de.pdf。指定 outputFormat 时，派生路径会改用该扩展名。
• 此处的样式规则和自定义指令为只读。请在你的 DeepL 账户中创建和编辑。

许可证

MIT