Deepl

@pipeworx/deepl

DeepL API MCP — 高品質な機械翻訳。無料枠は月間 50 万文字です。

Pipeworx の一部です。AI エージェントを 1878 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開されていません。

認証

• プラットフォーム：PLATFORM_DEEPL_KEY。BYO：?_apiKey=…。
• 無料枠のキーは末尾が :fx です（自動検出され、無料エンドポイントが選択されます）。
• translate は現在、Pipeworx の共有キーでは拒否されます（HTTP 456）。文字数の上限によるものではありません。2026-08-28 に測定したところ、同じキーで usage を呼び出すと、character_limit が上限に達している状態でも character_count: 0 が返される一方、次の呼び出しでは translate が 456 を返しました。それ以前の 7 日間の成功は 0 件でした。待っても解除されません。_apiKey にご自身のキーを渡してください。読み取り専用ツール（usage、source_languages、target_languages、glossary_language_pairs）は引き続き共有キーで利用できます。Fleet #577。

ツール

• translate(text, target_lang, source_lang?, split_sentences?, preserve_formatting?, formality?, glossary_id?, tag_handling?, outline_detection?, non_splitting_tags?, splitting_tags?, ignore_tags?) — テキストを翻訳します（1 つまたは複数の文字列）
• usage() — 今月の使用状況と上限
• source_languages() — 対応している原文の言語
• target_languages() — 対応している翻訳先の言語
• glossary_language_pairs() — 対応している用語集の言語ペア

text には文字列または文字列の配列を指定できます。target_lang の例：EN-US、DE、JA、ES、FR。formality：default | more | less | prefer_more | prefer_less。

データソース

https://api.deepl.com/v2（有料） | https://api-free.deepl.com/v2（無料、キーの末尾が :fx の場合に自動選択）

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "deepl": {
      "url": "https://gateway.pipeworx.io/deepl/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/deepl/mcp に対する tools/list は、上の表に記載されたツールに加えて、Pipeworx の共有メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える一連のツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに、共有ツールがおよそ 30 個一覧表示されます。接続の initialize 応答には正確な範囲が記載され、その日の状況を確認するための正式な情報となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うことで、このパックでは対応できない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を介して回答できます。MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントに接続する代わりに、ゲートウェイ全体へ一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと 1878 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

当社の deepl キーは有料アカウント用に確保されているため、POST https://gateway.pipeworx.io/v1/tools/deepl_translate を匿名で呼び出すには、引数とともにご自身のキーを _apiKey として渡す必要があります。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/deepl_translate を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です：

{
  "mcpServers": {
    "deepl": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-deepl"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-deepl

stdin／stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使いますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx での使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。 これは、上記のパックエンドポイントでも、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Deepl data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT