DeepL MCP Server

Сервер MCP (Model Context Protocol), предоставляющий высококачественные возможности перевода через 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 в реальном времени; потоковая передача аудио осуществляется через возвращенный URL WebSocket

• Опции DeepL Write — Перефразирование с помощью writing_style и tone, если тарифный план поддерживает Write API

• Контроль разбиения предложений — Управление тем, как разбиваются предложения

Автоматическое определение типа API

Сервер автоматически определяет, используете ли вы бесплатный или платный API, основываясь на формате вашего ключа:

• Ключи, заканчивающиеся на :fx → Бесплатный API (api-free.deepl.com)

• Другие ключи → Платный API (api.deepl.com)

Related MCP server: AiryLark MCP Translation 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. Ключи бесплатного API могут возвращать ожидаемую ошибку плана для DeepL Write.

Лицензия

Лицензия MIT — см. файл LICENSE.

Ссылки

• Документация DeepL API

• DeepL Pro API — Зарегистрируйтесь для доступа к API

• Model Context Protocol — Документация MCP