DeepL MCP Server

DeepL MCP服务器

MCP（模型上下文协议）服务器通过 DeepL API.

特性

该服务器提供了24个使用DeepL的工具：

翻译特点

• 下一代车型选择 --使用 model_type 值，例如 quality_optimized 或 prefer_quality_optimized
• 形式控制 --调整正式/非正式语境的语调
• 上下文参数 --提供额外的上下文以提高准确性（不收费）
• 术语表支持 --创建、列出、检查、使用和删除DeepL v3术语表
• 批量翻译 --在一个请求中翻译多个文本
• 保留格式 --保留原始文本格式
• HTML/XML标签处理 --使用 tag_handling, tag_handling_version, ignore_tags, splitting_tags，以及相关选项
• 账单可见性 --使用 show_billed_characters 在翻译回复中包括计费字符数
• 文件翻译 --上传、投票和下载翻译文件
• v3语言元数据 --检索产品特定的语言支持和功能规则
• 翻译记忆 --列出帐户翻译记忆库并在翻译请求中使用它们
• 样式规则 --列出、创建、检查、重命名、删除和使用样式规则列表
• 语音会话设置 --请求或重新连接DeepL Voice实时WebSocket会话；音频流由返回的WebSocket URL完成
• DeepL写入选项 --重新表述 writing_style 和 tone 当计划支持Write API时
• 句子分割控制 --控制句子的分割方式

API类型自动检测

服务器会根据您的密钥格式自动检测您使用的是Free还是Pro API：

• 以结尾的密钥 :fx → 免费API(api-free.deepl.com)
• 其他键→ 专业API(api.deepl.com)

先决条件

• Node.js 18+ （包括Node.js 25）
• DeepL API密钥 — 在这里注册 （提供免费套餐）

快速开始

1.克隆和构建

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

2.配置您的MCP客户端

添加到MCP客户端配置中：

克劳德桌面 (~/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"
      }
    }
  }
}

克劳德代码 (.mcp.json 在您的项目中）：

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

3.重新启动MCP客户端

重新启动Claude Desktop或Claude Code以加载服务器。

用法示例

基础翻译

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

形式翻译与语境

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

批量翻译

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

检查API使用情况

使用 get_usage 查看您当前的配额：

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

支持的语言

源语言（如果省略，则自动检测）

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

目标语言

所有源语言加上地区变体：

• EN-GB --英国英语
• EN-US --美式英语
• PT-BR --巴西葡萄牙语
• PT-PT --欧洲葡萄牙语
• ZH-HANS --简体中文
• ZH-HANT --繁体中文

使用 get_target_languages 查看带有形式支持指标的完整列表。

错误处理

服务器处理常见的API错误：

• 400 --无效参数
• 401/403 --身份验证失败或当前计划中没有可用功能
• 429 --超出费率限制
• 456 --超出配额

安全和OSV状态

此存储库已使用谷歌的OSV扫描仪进行扫描，并已修复为干净状态。

• 最新扫描结果： 0个已知的依赖漏洞
• 报告将发送至 .osv/osv-report.json 和 .osv/osv-summary.md
• 补救说明见 .osv/remediation-notes.md
• 通过升级修复了易受攻击的直接依赖链 @modelcontextprotocol/sdk 和 axios

在本地运行扫描：

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

发展

# 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

实时测试练习翻译、语言列表、v3语言元数据、翻译记忆库列表、样式规则列表/创建/获取/更新/删除（如果可用）、语音会话请求（如果可用的话）、用法、术语表创建/使用/删除、文档上传/状态/下载和DeepL Write。免费的API密钥可能会返回DeepLWrite的预期计划错误。

许可证

MIT许可证——见 许可证 文件。

链接

• DeepL API文档
• DeepL Pro API -注册API访问
• 模型上下文协议 --MCP文件