deepl-mcp-server

deepl-mcp-server

メモ

最適な使用感と最新機能をお求めの場合は、DeepL リモート MCP サーバーをご利用ください。AI エージェントで DeepL を使用できます。インストールは不要です。Claude、ChatGPT、Microsoft Copilot、または任意の MCP クライアントに追加して、DeepL アカウントにサインインするだけです。

ターミナルまたはコーディングエージェントで作業していますか？DeepL CLI をお試しください。API キーを使って、翻訳、ドキュメント、用語集、i18n ファイルの同期に対応します。

DeepL のテキスト翻訳、ドキュメント翻訳、言い換え、用語集やスタイルルールの参照を MCP ツールとして提供する Model Context Protocol（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

設定

サーバーの環境変数に DEEPL_API_KEY を設定し、stdio サーバーとして登録してください。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	1 つの用語集辞書（1 方向の言語ペア）に含まれる用語エントリーを返します。	glossaryId, sourceLangCode, targetLangCode
list-style-rules	アカウント内のスタイルルールについて、ID、名前、言語、タイムスタンプを一覧表示します。	page?, pageSize?, detailed?
get-style-rule	設定済みのルールとカスタム指示を含む、1 つのスタイルルールの全情報を返します。	styleId
get-custom-instruction	スタイルルールに属する 1 つのカスタム指示を返します。	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