DeepL MCPサーバー

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

機能

このサーバーは、DeepLを操作するための24個のツールを提供します：

翻訳機能

• 次世代モデルの選択 — 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)

Related MCP server: GeoServer MCP Server

前提条件

• 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クライアントの設定に追加します：

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 ファイルを参照してください。

リンク

• DeepL APIドキュメント

• DeepL Pro API — APIアクセスの登録

• Model Context Protocol — MCPドキュメント