MCP-Lingvanex-Translate Server

официальный

Lingvanex MCP Server Cloud API – сервер протокола контекста модели, обеспечивающий быстрый и точный перевод текста с помощью Lingvanex Cloud API. Поддерживает более 100 языков и легко интегрируется с Claude Desktop и другими MCP-совместимыми клиентами.

GitHub

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

MCP Прототип – Сервер перевода

Этот проект реализует MCP (Model Context Protocol) сервер для перевода текста. Сервер поддерживает два транспорта:

  • stdio – для интеграции с Claude Desktop
  • http (потоковый) – для тестирования и работы через HTTP + SSE

⚙️ Требования

  • Node.js >= 18
  • Yarn или npm
  • Установленный Claude Desktop (для интеграции через stdio)
  • Аккаунт Lingvanex Translator для перевода текста

🔑 Настройка Lingvanex Translator

Для использования Lingvanex Translator вам понадобится аккаунт Lingvanex.

  1. Если у вас его нет, зарегистрируйтесь бесплатно
  2. Перейдите на вкладку Cloud API: Cloud API
  3. Заполните данные Billing Address
  4. Нажмите Continue to payment
    • Для получения бесплатного пробного периода не обязательно добавлять платежную карту
  5. Ваш API ключ будет сгенерирован и отображён на вкладке Cloud API: API key

Теперь вы готовы начать использовать API перевода. Ниже представлено видео-руководство по общему процессу (если доступно на сайте Lingvanex).

🚀 Установка и сборка

Клонирование репозитория

git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git cd mcp-prototype

Установка зависимостей

yarn install

🔌 Запуск в режиме stdio (Claude Desktop)

Режим stdio используется Claude Desktop для подключения к локальным MCP серверам.

Установите переменную окружения:

TRANSPORT=stdio

Запустите сервер:

yarn build yarn start

Ожидаемый вывод:

MCP stdio transport running
Translate MCP Server ready

🌐 Запуск в режиме HTTP (потоковый)

Режим http запускает локальный HTTP сервер с HTTP транспортом. Полезен для тестирования в браузере или с curl.

Установите переменные окружения:

TRANSPORT=http HTTP_PORT=3000

Проверьте сервер:

curl http://127.0.0.1:3000/ping

Ожидаемый ответ:

{ "status": "ok", "transport": "http" }

Используйте MCP Inspector для отладки:

npx @modelcontextprotocol/inspector

В интерфейсе MCP Inspector выберите Transport Type - Streamable HTTP; URL - http://localhost:3000/mcp. Нажмите Connect.

🖥️ Интеграция с Claude Desktop

Claude Desktop обнаруживает локальные MCP серверы через файл конфигурации:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Пример конфигурации (Windows)

Откройте (или создайте) claude_desktop_config.json и добавьте:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\path\to\project\dist\index.js" ] } } }

⚠️ Убедитесь, что путь к вашему локальному dist/index.js обновлён после сборки!

✅ Как проверить

  1. Запустите Claude Desktop.
  2. Введите запрос, например:"Используйте инструмент MCP translatetext для перевода 'Hello world' на русский."
  3. Если всё настроено правильно, Claude вызовет ваш MCP сервер и вернёт перевод.

📌 Доступные инструменты

translate_text

Перевод текста с одного языка на другой.

Аргументы:

  • text – текст для перевода
  • sourceLang – код исходного языка (например, "en")
  • targetLang – код целевого языка (например, "ru")

Пример запроса:

{ "tool": "translate_text", "args": { "text": "Good morning", "sourceLang": "en", "targetLang": "fr" } }

Пример ответа:

{ "content": [ { "type": "text", "text": "Bonjour" } ] }