DeepL MCP Server

DeepL MCP Server

DeepL API を介して高品質な翻訳機能を提供する MCP（Model Context Protocol）サーバーです。

機能

このサーバーは、DeepL を利用するための 24 個のツールを提供します。

ツール	説明	必須パラメーター
translate_text	フォーマル度、コンテキスト、用語集、モデル、タグ処理、スタイル、翻訳メモリ、カスタム指示のオプションを指定してテキストを翻訳します	text、target_lang
rephrase_text	任意の文体やトーンを指定し、DeepL Write でテキストの明瞭さとスタイルを改善します	text
get_source_languages	v2 の翻訳元言語を一覧表示します	—
get_target_languages	フォーマル度のサポート情報を含む v2 の翻訳先言語を一覧表示します	—
get_usage	API の使用統計を取得します	—
get_languages_v3	機能メタデータを含む、製品ごとにベータ版 v3 がサポートする言語を取得します	—
get_language_products_v3	ベータ版 v3 の言語製品と機能ルールを取得します	—
get_glossary_language_pairs	用語集がサポートする言語ペアを一覧表示します	—
list_glossaries	v3 の用語集を一覧表示します	—
get_glossary	v3 の用語集のメタデータを取得します	glossary_id
get_glossary_entries	用語集の辞書エントリーを取得します	glossary_id
create_glossary	v3 の多言語用語集を作成します	name、dictionaries
delete_glossary	v3 の用語集を削除します	glossary_id
list_translation_memories	アカウントで利用可能な v3 の翻訳メモリを一覧表示します	—
list_style_rules	v3 のスタイルルールリストを一覧表示します	—
get_style_rule	v3 のスタイルルールリストを取得します	style_id
create_style_rule	v3 のスタイルルールリストを作成します	name、language
update_style_rule	v3 のスタイルルールリスト名を更新します	style_id、name
delete_style_rule	v3 のスタイルルールリストを削除します	style_id
request_voice_session	DeepL Voice のリアルタイム WebSocket セッションをリクエストします	source_media_content_type、target_languages
reconnect_voice_session	DeepL Voice のリアルタイム用の新しいトークンをリクエストします	—
upload_document	ドキュメント翻訳用にローカルファイルをアップロードします	file_path、target_lang
get_document_status	ドキュメント翻訳のステータスを確認します	document_id、document_key
download_document	翻訳済みドキュメントをローカルパスにダウンロードします	document_id、document_key、output_path

翻訳機能

• 次世代モデルの選択 — quality_optimized や prefer_quality_optimized などの model_type 値を使用します
• フォーマル度の調整 — フォーマルまたはカジュアルな場面に合わせてトーンを調整します
• コンテキストパラメーター — 精度向上のために追加のコンテキストを指定します（課金対象外）
• 用語集のサポート — DeepL v3 の用語集の作成、一覧表示、確認、使用、削除ができます
• 一括翻訳 — 1 回のリクエストで複数のテキストを翻訳します
• 書式の保持 — 原文の書式を保持します
• HTML/XML タグの処理 — tag_handling、tag_handling_version、ignore_tags、splitting_tags などのオプションを使用します
• 課金状況の確認 — show_billed_characters を使用して、翻訳レスポンスに課金対象の文字数を含めます
• ドキュメント翻訳 — 翻訳済みファイルのアップロード、ポーリング、ダウンロードができます
• v3 言語メタデータ — 製品固有の言語サポートと機能ルールを取得します
• 翻訳メモリ — アカウントの翻訳メモリを一覧表示し、翻訳リクエストで使用します
• スタイルルール — スタイルルールリストの一覧表示、作成、確認、名前変更、削除、使用ができます
• 音声セッションの設定 — DeepL Voice のリアルタイム WebSocket セッションをリクエストまたは再接続します。音声ストリーミングは、返される WebSocket URL を介して行われます
• DeepL Write のオプション — プランが Write API に対応している場合、writing_style と tone を指定して言い換えます
• 文の分割方法の制御 — 文の分割方法を制御します

API タイプの自動検出

サーバーはキーの形式に基づいて、Free API と Pro API のどちらを使用しているかを自動的に検出します。

• :fx で終わるキー → Free API（api-free.deepl.com）
• それ以外のキー → Pro API（api.deepl.com）

前提条件

• Node.js 18+（Node.js 25 を含む）
• DeepL API Key — こちらから登録（無料プランを利用できます）

クイックスタート

1. クローンしてビルドする

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

2. MCP クライアントを設定する

MCP クライアントの設定に追加します。

Claude Desktop（~/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"
      }
    }
  }
}

Claude Code（プロジェクト内の .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 のステータス

このリポジトリは Google の OSV-Scanner によるスキャンを受けており、脆弱性のない状態に修正されています。

• 最新のスキャン結果：既知の依存関係の脆弱性は 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 をテストします。Free API キーでは、DeepL Write に対してプランに起因する想定内のエラーが返される場合があります。

ライセンス

MIT License — LICENSE ファイルを参照してください。

リンク

• DeepL API ドキュメント
• DeepL Pro API — API アクセスの登録
• Model Context Protocol — MCP ドキュメント